开始之前
沙箱如何模拟拒绝
Stage 不会转移真实资金,但其流程与 Production 相同:Localpayment 收到您的请求后会验证请求结构,如果格式正确,则将其设为In Progress,并根据您提交的账户详情路由至模拟的银行响应。该响应决定批准还是拒绝该付款。您可以通过常规方式获知结果:通过 Webhook,或查询交易状态。
任何请求结构正确的付款都会被自动批准。本指南中的测试账户是例外:每个账户都映射到特定的拒绝原因,因此您可以按需重现该错误情形,而无需等待其自然发生。
- 您使用下表中的某个测试账户在 Stage 中提交付款。
- Localpayment 验证请求结构,如果有效,则在路由至模拟的银行响应期间将付款设为
In Progress。 - 模拟的银行响应会评估收款人账户详情。结构正确但与下列测试账户均不匹配的账户会被自动批准。测试账户则会以其映射的代码被拒绝。
- Localpayment 通过您的 Webhook endpoint 通知您最终状态,您也可以通过查询交易来获取。借此可确认您的集成能对
REJECTED付款作出正确响应,而无需等待真实的银行拒绝。
这些测试账户仅适用于 Stage。在 Production 中向这些账户付款不会产生相同的结果,因为 Production 会路由至真实银行。
拒绝代码
下面的每个测试账户都会返回以下五种结果之一。它们均会产生状态为REJECTED 的付款,并带有相应的 status.code 和 status.description。
各国测试账户
每个标签页列出一个国家的收款银行详情。每个场景共用相同的paymentMethod.code,并且除非另有说明,该国家的 beneficiary.bank.code 和 beneficiary.bank.name 也相同。account.details 是要在 beneficiary.bank.account.number(或在特别注明时为 beneficiary.bank.account.alias)中发送的值,用于触发对应的拒绝代码。Description是您在该代码的响应和 Webhook 中看到的 status.description。
- 阿根廷
- 玻利维亚
- 巴西
- 智利
- 哥伦比亚
- 哥斯达黎加
- 多明尼加共和国
- 萨尔瓦多
- 危地马拉
- 洪都拉斯
- 墨西哥
- 巴拿马
- 巴拉圭
- 秘鲁
付款方式: COELSA,代码
0010 · 银行: BANCO DE GALICIA (007) · account.type: S · account.details 为 CBUaccount.type 为 C(支票账户)时同样适用于这些场景。字段映射参考
上述测试账户会填充创建付款中的标准beneficiary.bank 对象:
通过校验位验证的账号(墨西哥 CLABE、阿根廷 CBU,以及哥斯达黎加、多明尼加共和国和萨尔瓦多使用的 IBAN 格式)是结构上有效的测试值,并非真实账户。它们的唯一用途是触发所映射的拒绝场景。
后续步骤
通过银行转账汇款
创建银行转账付款的完整 API 参考,包括各国具体要求。
退货与召回
了解付款在 Production 中被拒绝或完成后被退回时会发生什么。

