跳转到主要内容
了解如何通过在测试环境中模拟收款来测试您的虚拟账户集成。无需实际银行转账即可验证您的 Webhook 监听器和对账逻辑。 在正式上线之前,测试虚拟账户集成至关重要。为了方便测试,Localpayment 在 Stage 环境 中提供了一个模拟 endpoint,允许您向任何已激活的虚拟账户触发模拟收款。 该模拟模仿了真实的本地 ACH 转账行为,触发了与生产环境中预期相同的内部状态更新和 webhook 通知。

模拟流程

  1. 创建虚拟账户:首先,在测试环境中生成一个虚拟账户。
  2. 获取虚拟账户状态:使用 获取虚拟账户状态 endpoint 确认账户已成功创建,并从响应中获取 beneficiary.bank.account.number 字段。
  3. 关联模拟:在模拟请求中,使用上一步获得的 beneficiary.bank.account.number,将模拟付款关联到正确的账户。此外,请提供唯一的 externalId——它将作为本次交易所生成的 payin 的 ID;每次模拟请求都请使用不同的 externalId。您还必须提供您的 Localpayment accountNumber(商户 ID),以识别与模拟支付关联的商户账户。
  4. 触发模拟:调用 模拟虚拟账户支付 endpoint。
  5. 接收 Webhook:Localpayment 将发送一个 payin.completed(或类似)webhook 到您配置的 endpoint。
  6. 验证状态:使用交易状态 API 确认模拟交易已达到预期状态。

技术依赖关系

顺序要求:您不能模拟尚未成功创建的账户的付款。如果 创建虚拟账户 调用失败,模拟尝试将返回 404 Not Found 错误。

代码示例(Stage)

选择您的目标市场,查看完整的 curl 示例。请使用创建虚拟账户时提供的相同受益人数据,并为每次模拟请求提供唯一的 externalId。

Webhook 通知示例

处理成功后,Localpayment 会向您配置的 endpoint 发送同步的 payin.completed 事件。该通知遵循所有支付产品通用的标准高级 PayIn 结构。

故障排除


后续步骤

验证状态

获取实时状态更新以确认模拟交易进度。

配置 Webhooks

通过实时成功通知验证您的监听器逻辑。
最后修改于 2026年11月10日