跳转到主要内容
在正式上线银行转账付款之前,使用 Stage 测试账户触发特定的付款拒绝场景。 在 Production 环境中向真实收款人付款之前,请先使用 Stage 环境确认您的集成既能处理付款成功的情况,也能处理收款人银行在实际中返回的各类拒绝场景。本指南介绍银行转账付款的沙箱流程,并提供按国家划分的专用测试账户,每个账户都会确定性地触发对应的拒绝场景。

开始之前


沙箱如何模拟拒绝

Stage 不会转移真实资金,但其流程与 Production 相同:Localpayment 收到您的请求后会验证请求结构,如果格式正确,则将其设为 In Progress,并根据您提交的账户详情路由至模拟的银行响应。该响应决定批准还是拒绝该付款。您可以通过常规方式获知结果:通过 Webhook,或查询交易状态。 任何请求结构正确的付款都会被自动批准。本指南中的测试账户是例外:每个账户都映射到特定的拒绝原因,因此您可以按需重现该错误情形,而无需等待其自然发生。
  1. 您使用下表中的某个测试账户在 Stage 中提交付款。
  2. Localpayment 验证请求结构,如果有效,则在路由至模拟的银行响应期间将付款设为 In Progress。
  3. 模拟的银行响应会评估收款人账户详情。结构正确但与下列测试账户均不匹配的账户会被自动批准。测试账户则会以其映射的代码被拒绝。
  4. 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 中被拒绝或完成后被退回时会发生什么。
最后修改于 2026年11月10日