VietQR 是什么？
VietQR 是越南的全国二维码支付标准，由国家支付清算机构 NAPAS 运营。一种码制通吃全国：几乎所有零售银行和主流电子钱包的 App 都能识别同一张码，这让它成为越南消费者从路边摊到电商的默认付款方式。
对企业来说，VietQR 取代的是手工银行转账：不再是把静态账号发给用户、指望对方输对金额和附言，而是出示一张已内嵌金额与订单号的动态码。用户扫码确认，账就自动对上了。
关键信息
- 标准
- VietQR / NAPAS 247，兼容 EMVCo
- 覆盖
- 越南主要银行与电子钱包 App 均可识别
- 币种
- VND（越南盾）
- 代收到账
- 用户确认后通常 1–3 分钟
- 可用时间
- 7×24，含周末与节假日
- 码型
- 动态码——每笔交易内嵌金额与订单号
- 限额
- 单笔与单日限额以商户配置为准
在 CVPay 上如何使用
代收（用户付款）
通过 API 创建订单，拿到与订单绑定的 VietQR 码，嵌入你的收银页或直接使用 CVPay 托管收银台。用户用任意越南银行或钱包 App 扫码，回调通常 1–3 分钟内送达。因为每张码都是动态码，少付和无主转账从机制上被消除，而不是事后人工核对。
代付（打款）
同一平台支持向任意 VietQR 可达的银行账户发起 VND 代付，走 24/7 快速转账网络。打款前可做收款人姓名核验，最终状态推送至回调地址，白天深夜通常都是分钟级到账。
接入方式
一套 REST API 覆盖 CVPay 支持的全部支付方式：创建订单、向用户展示返回的二维码或账户信息、在回调地址接收结果。提供托管收银台与沙盒环境，多数商户几天内即可完成对接上线。
curl -X POST 'https://{api-base}/api/pay/qrcode' \
-d 'mchNo=M1234567890' \
-d 'appId=YOUR_APP_ID' \
-d 'mchOrderNo=ORDER-2026-0001' \
-d 'wayCode=QRCODE247' \
-d 'currency=vnd' \
-d 'amount=500000' \
-d 'sign=...'
# 响应包含与该订单绑定的 VietQR 码。
# 简化示例——完整字段与 MD5 签名规则见 API 文档。常见问题
哪些银行和钱包能扫 VietQR 码付款？+
基本全部。VietQR 是国家标准，越南主要零售银行的用户和主流电子钱包用户都能用自己的 App 扫同一张码。
动态码和静态码有什么区别？+
静态码只编码账户信息，金额和附言要用户手输——这是对账错误的最大来源。CVPay 出具的是动态码，金额与订单号已内嵌，付款自动匹配订单。
多久到账？+
用户在 App 确认后通常 1–3 分钟内到账，7×24 可用，结果通过带签名的回调通知你的系统。
二维码会过期吗？+
会。每张码与订单绑定并有有效期。用户超时后付款，款项仍可通过订单找回流程匹配回订单，不会丢失。
代付也能用 VietQR 吗？+
代付以账对账快速转账送达任意越南银行账户，覆盖所有 VietQR 可达的收款人。代付侧也支持解析收款人的 VietQR 码，自动回填其账户信息。
