VietQR 是一个专为越南银行转账设计的轻量级命令行工具，能够根据银行账户信息和转账金额自动生成符合标准的 VietQR 支付链接。该工具通过解析用户输入的银行名称、账号、金额及备注等参数，输出可直接用于支付的二维码图片 URL 或 Markdown 格式预览代码。其核心优势在于支持多种便捷输入方式，包括数字简写（如 `10k`、`2.5k`）、越南语金额表达（如 `1,5tr`、`200.000đ`）以及常见银行别名（如 `vcb`、`mb`、`bidv`），极大提升了使用效率。生成的链接兼容主流越南银行系统，确保扫码支付流程顺畅可靠。无论是开发者集成到自动化系统，还是普通用户在聊天或文档中快速分享收款信息，VietQR 都能提供简洁高效的解决方案。
核心功能特点
- 支持多种金额输入格式，包括阿拉伯数字简写（如 10k、2.5k）和越南语习惯表达（如 1,5tr、200.000đ）
- 内置常见越南银行别名映射，自动识别 vcb、mb、bidv、vietinbank 等缩写并转换为标准银行代码
- 可生成标准 VietQR 支付链接，并支持输出 Markdown 格式的二维码图片预览代码
- 提供紧凑模板（compact2）优化显示效果，适配不同场景下的视觉需求
- 自动校验输入有效性，错误时返回明确提示并要求修正对应字段
适用场景
VietQR 特别适合需要频繁处理越南本地支付场景的开发者与业务人员。例如，在电商系统中为越南客户提供一键扫码付款功能时，可通过调用脚本快速生成带金额的 VietQR 链接，嵌入订单页面提升支付转化率。对于财务人员而言，在内部审批流程中批量生成固定收款码也十分高效。此外，若需在 Telegram、微信或 Notion 等不支持直接渲染二维码的平台分享收款信息，使用 `–markdown` 参数即可输出可直接粘贴的 Markdown 代码，极大简化沟通成本。该工具还可作为 API 的前置处理层，由智能代理自动规范化用户输入后再执行脚本，避免因格式混乱导致生成失败。由于其轻量无依赖的设计，也适合集成到 CI/CD 流程或自动化脚本中，实现无人值守的支付链接生成。