开始之前
请确保您已备好:- 有效的 API 凭证(访问令牌)。
步骤 1. 创建 Debin 付款
要生成 Debin 付款请求,请使用 Debin 特定参数向创建 Payin endpoint 发送POST 请求。
付款请求只能发送至 CBU 账户。这些账户的识别特征是前三位数字不以零开头。
关键请求参数
该请求需要几个与 Debin 支付相关的关键对象:
查看请求中所有可用的参数。
示例请求
以下是使用curl 的示例:
curl
只有当客户在其银行应用程序中确认接受付款后,付款才算完成。如果客户拒绝付款,则付款将被拒绝。否则,付款状态将变为已过期。
步骤 2:处理响应
成功响应
成功创建 Debin 付款包括付款请求详情和授权流程:关键响应字段
错误响应
Debin 请求创建失败时,您将收到详细的错误信息:步骤 3. 处理授权流程
- 支付发起:您的应用程序向 Localpayment API 发送 DEBIN 请求。
- 银行网络处理:Localpayment 通过阿根廷银行系统进行支付。
- 客户通知:客户在其银行应用程序中收到实时提醒。
- 付款授权:客户直接在银行界面批准付款。
- 确认和 Webhook:Localpayment 会立即发送包含最终付款状态的 webhook。
- 订单履行:您的应用程序会根据付款结果更新订单状态。
第四步:跟踪交易状态
您可以通过以下方式监控 Debin 的付款进度:Webhooks(推荐)
交易状态变更时接收实时通知。最适用于生产环境。
状态 API endpoint
以编程方式查询事务状态。可用于轮询或恢复丢失的 webhook 通知。
Business Portal 视图
用于监控交易的可视化界面。非常适合人工监督和详细的交易分析。
常用状态码
Localpayment API 提供各种状态代码来指示 Debin 付款的进度和结果。完整参考请查看我们的交易状态文档,了解所有状态代码。
测试您的集成
沙盒环境
使用测试环境:测试 Debin 场景
请确认您的集成方案能够处理以下场景:- 授权成功:Debin 授权流程完成。
- 授权过期:处理已过期的授权请求。
- 状态更新:Webhook 处理和状态轮询。
后续步骤
实施 Debin 支付后,请考虑以下附加功能:退款
如有必要,您可以将款项退还给客户。详情请参阅相关文档。
查看交易详情
您可以使用 Localpayment API 获取交易信息,以获得更详细的分析。

