二维码关键数据
阿根廷的转账二维码
阿根廷的数据，阿根廷是本页四个二维码市场中最大的一个（BCRA，2025 年零售支付年度报告）。
841.2 百万
通过转账实现的互通支付 (PCT，主要为二维码; 笔交易, 2025)
80 百万
使用二维码支付的公共交通出行，VQR (略低于, 2025)
64.1%
即时支付占零售支付笔数的比重 (占业务笔数百分比, 2025)
61%
涉及 CVU 账户的即时推送转账占比 (占转账笔数百分比, 超过, 2025)
简介
一种 QR 方式，四个本地市场
QR 是一种替代支付方式：付款人扫描二维码，并在银行或钱包 App 中确认付款，不涉及银行卡数据。该方式为异步，最终状态始终通过签名 webhook 送达。Localpayment 在阿根廷、玻利维亚和秘鲁提供该方式，在危地马拉则为 QR Fri（SoyFri）。各国限额不同，请参阅关键信息表。
- 阿根廷（1050）、玻利维亚（1150）、秘鲁（6080）和危地马拉 QR Fri（1870）
- 付款人在银行或钱包 App 中确认；无需银行卡数据
- 通过同一个 Create Payin 端点，最终状态由签名 webhook 送达
Escanea el QR · vence en 29:59
Ya pagué工作原理
QR 支付流程
参与方和步骤遵循文档中的流程。最终状态始终通过签名 webhook 送达。
- 1
您的企业Localpayment:
生成二维码
调用 POST /api/payin/，传入国家、币种、金额和付款人信息。响应返回供付款人扫描的二维码；在最终状态到达之前，付款保持待处理。
- 2
付款人银行 · QR:
客户在银行或钱包 App 中扫码
付款人在银行或钱包 App 中扫描二维码并确认付款。
- 3
银行 · QRLocalpayment:
付款
Localpayment 收到确认并更新交易状态。
- 4
Localpayment您的企业:
Webhook
使用 HMAC-SHA256 签名（x-Signature）。状态 200 表示已完成，请按 externalId 去重。
示意图已简化。时效取决于支付通道和银行，详见下方关键信息。
工作原理
QR 实际体验
简化的虚构演示，名称和金额仅为示例。
- 1QR向付款人显示二维码（或可复制的代码）。
- 2Banco Ejemplo付款人核对 PEN 120.00 并在银行或钱包 App 中确认。
- 3付款成功您的系统收到签名 webhook 并放行订单。
关键信息
QR：关键信息
国家
- 详情
- 🇦🇷 阿根廷 · 🇧🇴 玻利维亚 · 🇬🇹 危地马拉 · 🇵🇪 秘鲁
币种
- 详情
- ARS · BOB · GTQ · PEN
方向
- 详情
- 仅收款
阿根廷 · 二维码支付
- 详情
- 异步，通过 webhook 确认 · ARS 1 – 10,000,000
玻利维亚 · 二维码支付
- 详情
- 异步，通过 webhook 确认 · BOB 1 – 1,000,000
危地马拉 · QR Fri（SoyFri）
- 详情
- 异步，通过 webhook 确认 · GTQ 1 – 10,000
秘鲁 · 二维码支付
- 详情
- 异步，通过 webhook 确认 · PEN 1 – 500
状态
- 详情
- Webhook
摘自 Localpayment 各国文档。限额和可用性可能变化，请与您的客户经理确认。
用户体验
客户使用 QR 时的体验
授权方式、限额和退款均依据 docs.localpayment.com；仅在文档明确说明时才显示限额。
客户如何授权
客户使用银行或钱包 App 扫描二维码，选择扣款账户（您无需发送其银行信息），核对金额后确认。每个二维码在响应中都有有效期：在危地马拉，QR Fri 代码生成后五分钟过期，请显示倒计时并在需要时重新生成。
文档中的限额
二维码支付 (收款): ARS 1 – 10,000,000 · 二维码支付 (收款): BOB 1 – 1,000,000 · QR Fri（SoyFri） (收款): GTQ 1 – 10,000 · 二维码支付 (收款): PEN 1 – 500. 按单笔计，依据已发布文档；合同限额可能不同。
退款与退回
已完成的收款可通过 PATCH /api/payin/{externalId}/refund 退款。仅支持全额退款；资金退回付款人的银行账户，交易以状态 902（REFUNDED）结束。付款仍在待处理时可改为取消。
集成清单
五步上线 QR
所有通道流程一致。开发前先观看该国的动画结账演示。
获取 Stage 凭证
申请接入，获取沙盒凭证，并通过 POST /api/token/ 获取 JWT。
创建收款
调用 POST /api/payin/，传入关键信息表中的 Localpayment 代码、ISO-3 国家、币种、金额和付款人信息。
展示支付指引
根据响应展示二维码、代码、跳转或账户信息，并遵守有效期。
校验 webhook
验证 x-Signature（HMAC-SHA256），在状态 200 时放行订单，并按 externalId 去重。
观看动画结账演示
在结账体验画廊中逐屏查看该国的每种支付方式。
发展历程
区域内二维码如何实现互通
来源：BCRA《2025 年零售支付年度报告》；玻利维亚中央银行；秘鲁中央储备银行（BCRP）第 024-2022-BCRP 号通告；危地马拉银行。
阿根廷：Transferencias 3.0
BCRA 使转账二维码支付实现互通：任何钱包或银行 App 都能支付任何二维码，自 2021 年末起强制执行。
秘鲁：互通通告
BCRP 要求钱包与银行互通；自 2023 年起，银行 App 和钱包均可读取二维码。
玻利维亚：二维码增长 48 倍
玻利维亚中央银行的互通二维码方案使二维码支付金额从 2021 年的 32 亿玻利维亚诺增至 2024 年的 1570 亿。
阿根廷：8.41 亿笔二维码转账
转账支付（PCT，主要为二维码）达到 8.41 亿笔，全年增长 40.7%，另有近 8000 万次二维码支付的公共交通出行。
为什么选择 Localpayment
为什么通过 Localpayment 使用 QR
一个 API 处理收款与付款
QR 与其他所有支付方式使用同一个 API：POST /api/payin/ 收款，POST /api/payout/ 付款，新增市场只需配置。
每笔交易均通过 webhook 推送状态
每次状态变更都会推送至您的接口并使用 HMAC-SHA256 签名，便于校验和自动化。
在 Business Portal 中对账
通过您的 externalId 和我们的 internalId 对账每笔交易，并提供 Business Portal 报表和余额 API。
常见问题
QR 常见问题
二维码支付在哪些国家可用？
阿根廷（代码 1050）、玻利维亚（1150）、秘鲁（6080）和危地马拉，在危地马拉称为 QR Fri 或 SoyFri（1870）。
付款如何确认？
QR 为异步方式。付款人在银行或钱包 App 中确认，最终状态通过签名 webhook 通知您，请以该通知驱动订单流程。
限额是多少？
玻利维亚：BOB 1 至 1,000,000；秘鲁：PEN 1 至 500；危地马拉：GTQ 1 至 10,000；阿根廷：ARS 1 至 10,000,000。请与客户经理确认您的限额。
创建二维码需要付款人的银行账户吗？
不需要。阿根廷文档明确说明：无需发送付款人账户，客户扫码时自行选择。玻利维亚和秘鲁的二维码流程同理。
二维码应该多大？
至少以 250×250 像素呈现（玻利维亚文档如此规定）并保证足够对比度，同时在旁边显示金额以便付款人确认前核对。
二维码退款如何处理？
仅支持全额，对已完成收款调用 PATCH /api/payin/{externalId}/refund。在阿根廷，退款请求需附付款人银行信息，以便通过本地网络退回资金。
危地马拉哪些 App 可以支付 QR Fri？
文档列出了 Fri 钱包以及参与银行和 Micoope 合作社的 App；两家大型银行未参与。上线前请在文档中核对最新名单。