开始之前
请确保您已备好:- 有效的 API 凭证(访问令牌)。
第一步:创建二维码支付
要生成用于收款的二维码,请向 创建付款 endpoint 发送POST 请求,并附带特定二维码参数。
您无需在请求中提供付款人的银行账户信息。客户在使用银行应用程序扫描二维码时会自动选择其银行账户。
关键请求参数
该请求需要几个与二维码支付相关的关键对象:
查看请求中所有可用的参数。
示例请求
以下是使用curl 的示例:
curl
步骤 2:处理响应
成功响应
成功的二维码支付创建包括二维码数据和支付详情:关键响应字段
错误响应
二维码生成失败时,您将收到详细的错误信息:步骤三:显示二维码并处理付款
- 二维码展示:通过选定的渠道向客户展示二维码。
- 银行App扫描:客户使用阿根廷银行手机App扫描二维码。
- 付款授权:客户在其银行系统中确认付款。
- 实时确认:Localpayment 可立即收到付款通知。
- 状态更新:您的系统已收到包含付款确认信息的 webhook。

二维码展示的最佳实践
- 移动扫描的最小显示尺寸:250x250像素。
- 保持 1:1 宽高比,不失真。
- 确保高对比度(浅色背景上使用深色)。
- 在二维码周围添加静默区(白色边框)。
- 添加替代文字(例如“二维码支付”)。
- 显示清晰的付款说明。
- 处理生存时间(TTL)和过期时间。
第四步:跟踪交易状态
您可以通过以下方式监控二维码支付进度:Webhooks(推荐)
交易状态变更时接收实时通知。最适用于生产环境。
状态 API endpoint
以编程方式查询交易状态。可用于轮询或恢复丢失的 webhook 通知。
Business Portal 视图
用于监控交易的可视化界面。非常适合人工监督和详细的交易分析。
常用状态码
Localpayment API 提供各种状态代码,以在响应中指示付款的进度和结果。完整参考请查看我们的交易状态文档,了解所有状态代码。
测试您的集成
沙盒环境
使用测试环境:测试二维码场景
请确认您的集成方案能够处理以下场景:- 支付成功:完成二维码扫描和支付流程。
- 二维码过期:妥善处理过期二维码。
- 多次支付尝试:同一个二维码被多次扫描。
- 状态更新:Webhook 处理和状态轮询。
后续步骤
在实施二维码支付之后,请考虑以下附加功能:退款
如有必要,您可以将款项退还给客户。详情请参阅相关文档。
查看交易详情
您可以使用 Localpayment API 获取交易信息,以获得更详细的分析。

