跳转到主要内容
Localpayment 使商家能够通过阿根廷的 Debin(Débito Inmediato)系统处理即时银行转账。本指南概述了通过 Localpayment 的 API 发起 Debin 付款的流程,详细说明了所需的参数、响应处理以及状态代码解读,从而实现与阿根廷即时借记网络的无缝集成。
重要的Debin 付款将在创建日期后 2 天 过期。

开始之前

请确保您已备好:

步骤 1. 创建 Debin 付款

要生成 Debin 付款请求,请使用 Debin 特定参数向创建 Payin endpoint 发送 POST 请求。
付款请求只能发送至 CBU 账户。这些账户的识别特征是前三位数字不以零开头。

关键请求参数

该请求需要几个与 Debin 支付相关的关键对象: 查看请求中所有可用的参数。

示例请求

以下是使用 curl 的示例:
curl

只有当客户在其银行应用程序中确认接受付款后,付款才算完成。如果客户拒绝付款,则付款将被拒绝。否则,付款状态将变为已过期。

步骤 2:处理响应

成功响应

成功创建 Debin 付款包括付款请求详情和授权流程:

关键响应字段

错误响应

Debin 请求创建失败时,您将收到详细的错误信息:

步骤 3. 处理授权流程

  1. 支付发起:您的应用程序向 Localpayment API 发送 DEBIN 请求。
  2. 银行网络处理:Localpayment 通过阿根廷银行系统进行支付。
  3. 客户通知:客户在其银行应用程序中收到实时提醒。
  4. 付款授权:客户直接在银行界面批准付款。
  5. 确认和 Webhook:Localpayment 会立即发送包含最终付款状态的 webhook。
  6. 订单履行:您的应用程序会根据付款结果更新订单状态。

第四步:跟踪交易状态

您可以通过以下方式监控 Debin 的付款进度:

Webhooks(推荐)

交易状态变更时接收实时通知。最适用于生产环境。

状态 API endpoint

以编程方式查询事务状态。可用于轮询或恢复丢失的 webhook 通知。

Business Portal 视图

用于监控交易的可视化界面。非常适合人工监督和详细的交易分析。

常用状态码

Localpayment API 提供各种状态代码来指示 Debin 付款的进度和结果。
完整参考请查看我们的交易状态文档,了解所有状态代码。

测试您的集成

沙盒环境

使用测试环境:

测试 Debin 场景

请确认您的集成方案能够处理以下场景:
  1. 授权成功:Debin 授权流程完成。
  2. 授权过期:处理已过期的授权请求。
  3. 状态更新:Webhook 处理和状态轮询。

后续步骤

实施 Debin 支付后,请考虑以下附加功能:

退款

如有必要,您可以将款项退还给客户。详情请参阅相关文档。

查看交易详情

您可以使用 Localpayment API 获取交易信息,以获得更详细的分析。
最后修改于 2026年11月10日