银行跳转- 09:41:02.11409:41:02PayIn100 INPROGRESS20084 ms
- 09:41:05.90209:41:05PayIn200 COMPLETED20091 ms
- 09:42:18.33009:42:18PayOut100 INPROGRESS20077 ms
- 09:42:40.01809:42:40PayOut200 COMPLETED20088 ms
- 09:43:00.55109:43:00VirtualAccount200 COMPLETED20080 ms
POST https://example-merchant.com/webhooks/localpayment
x-Signature: HMAC-SHA256 3f9a1c0e…b47e2b
{ "transactionType": "PayIn", "transactionFlow": "DIRECT",
"data": { "externalId": "order_8F2K-1043",
"status": { "code": "200", "description": "COMPLETED" } } }关键数据
阿根廷的拉取式支付
数据由阿根廷中央银行（BCRA）和世界银行发布。
470.9 百万
即时拉取转账 (笔交易, 2025)
64.1%
即时支付占零售支付笔数的比重 (占业务笔数百分比, 2025)
65.6%
电子资金转账占零售支付笔数的比重 (占业务笔数百分比, 2025)
81.7%
拥有账户的成年人，金融机构或移动货币 (占 15 岁以上成年人百分比, 2024)
简介
从银行账户付款，由付款人确认
Debin 是阿根廷基于扣款请求的支付方式。您的企业通过 Localpayment 创建请求，付款人查看后在银行端确认，付款以异步方式确认。若未获确认，请求将在 2 天后失效。
- 由付款人在银行端确认的扣款请求
- 请求 2 天后失效
- 最终状态通过签名 webhook 送达
- 09:41:02.11409:41:02PayIn100 INPROGRESS20084 ms
- 09:41:05.90209:41:05PayIn200 COMPLETED20091 ms
- 09:42:18.33009:42:18PayOut100 INPROGRESS20077 ms
- 09:42:40.01809:42:40PayOut200 COMPLETED20088 ms
- 09:43:00.55109:43:00VirtualAccount200 COMPLETED20080 ms
POST https://example-merchant.com/webhooks/localpayment
x-Signature: HMAC-SHA256 3f9a1c0e…b47e2b
{ "transactionType": "PayIn", "transactionFlow": "DIRECT",
"data": { "externalId": "order_8F2K-1043",
"status": { "code": "200", "description": "COMPLETED" } } }工作原理
Debin 支付流程
参与方和步骤遵循文档中的流程。最终状态始终通过签名 webhook 送达。
- 1
您的企业Localpayment:
扣款请求
调用 POST /api/payin/，传入国家、币种、金额和付款人信息。响应确认扣款请求已创建，等待付款人处理。状态 100（INPROGRESS）。请求 2 天后失效。
- 2
银行 · Debin付款人:
银行通知
付款人的银行在网上银行或 App 中显示待处理的扣款请求。
- 3
付款人银行 · Debin:
付款人确认
付款人在银行端查看扣款请求并确认。
- 4
Localpayment您的企业:
Webhook
Localpayment 收到确认并更新交易状态。使用 HMAC-SHA256 签名（x-Signature）。状态 200 表示已完成，请按 externalId 去重。
示意图已简化。时效取决于支付通道和银行，详见下方关键信息。
工作原理
Debin 实际体验
简化的虚构演示，名称和金额仅为示例。
- 1Comercio Ejemplo客户选择 Debin 支付 ARS 45,000.00。
- 2Banco Ejemplo付款人核对 ARS 45,000.00 并在银行或钱包 App 中确认。
- 3付款成功您的系统收到签名 webhook 并放行订单。
关键信息
Debin：关键信息
国家
- 详情
- 🇦🇷 阿根廷
币种
- 详情
- ARS
方向
- 详情
- 仅收款
Debin
- 详情
- 异步，通过 webhook 确认 · ARS 1 – 10,000,000
流程
- 详情
- 付款人在其银行中确认扣款请求
摘自 Localpayment 各国文档。限额和可用性可能变化，请与您的客户经理确认。
用户体验
客户使用 Debin 时的体验
授权方式、限额和退款均依据 docs.localpayment.com；仅在文档明确说明时才显示限额。
客户如何授权
客户在您的结账页输入 CBU（银行账户；不接受钱包的 CVU）。其银行 App 中实时弹出请求，客户核对金额后批准。若拒绝，收款被拒；若不响应，创建两天后过期。
文档中的限额
Debin (收款): ARS 1 – 10,000,000. 按单笔计，依据已发布文档；合同限额可能不同。
退款与退回
已完成的收款可通过 PATCH /api/payin/{externalId}/refund 退款。仅支持全额退款；资金退回付款人的银行账户，交易以状态 902（REFUNDED）结束。付款仍在待处理时可改为取消。
集成清单
五步上线 Debin
所有通道流程一致。开发前先观看该国的动画结账演示。
获取 Stage 凭证
申请接入，获取沙盒凭证，并通过 POST /api/token/ 获取 JWT。
创建收款
调用 POST /api/payin/，传入关键信息表中的 Localpayment 代码、ISO-3 国家、币种、金额和付款人信息。
展示支付指引
根据响应展示二维码、代码、跳转或账户信息，并遵守有效期。
校验 webhook
验证 x-Signature（HMAC-SHA256），在状态 200 时放行订单，并按 externalId 去重。
观看动画结账演示
在结账体验画廊中逐屏查看该国的每种支付方式。
发展历程
Debin 的由来
来源：阿根廷中央银行（BCRA），《2025 年零售支付年度报告》。
BCRA 创建 Debin
央行定义即时借记（Débito Inmediato）：收款方发起扣款请求，付款人在自己的银行实时批准。
全银行体系上线
各银行在网银和手机 App 中推出 Debin，使其成为阿根廷首个即时拉取式支付工具。
纳入 Transferencias 3.0
Debin 成为互通即时支付框架中的拉取环节，与推送转账和转账二维码并列。
4.71 亿笔拉取转账
即时拉取转账全年达到 4.709 亿笔，即时支付占零售业务的 64%。
为什么选择 Localpayment
为什么通过 Localpayment 使用 Debin
一个 API 处理收款与付款
Debin 与其他所有支付方式使用同一个 API：POST /api/payin/ 收款，POST /api/payout/ 付款，新增市场只需配置。
每笔交易均通过 webhook 推送状态
每次状态变更都会推送至您的接口并使用 HMAC-SHA256 签名，便于校验和自动化。
在 Business Portal 中对账
通过您的 externalId 和我们的 internalId 对账每笔交易，并提供 Business Portal 报表和余额 API。
常见问题
Debin 常见问题
Debin 付款如何运作？
您通过 Localpayment 创建扣款请求，付款人在银行端确认。确认为异步方式，最终状态会通过签名 webhook 通知您，请以该通知驱动订单流程。
Debin 请求的有效期是多久？
Debin 请求在 2 天后失效。若付款人届时仍未确认，则付款不会完成，您可以重新创建请求。
适用哪个代码和限额？
Debin 在阿根廷使用 Localpayment 代码 1040。文档中的详细信息请见上方关键信息表，您账户的限额和可用性请与客户经理确认。
为什么文档只接受 CBU 账户？
Debin 请求路由至银行。CBU 标识银行账户且开头不会是三个零；钱包的 CVU 账户不适用于此方式，请引导这类用户使用二维码或 CVU 转账。
客户有多长时间批准？
自创建起两天。期间收款保持 100（INPROGRESS）；客户拒绝则被拒，无响应则过期。
可以退款 Debin 付款吗？
可以全额退款：对已完成交易调用 PATCH /api/payin/{externalId}/refund。收款以 902（REFUNDED）结束；不支持部分退款。
Debin 适合定期扣款吗？
每笔 Debin 都是客户在银行单独批准的请求。如需定期收款，请与销售团队咨询阿根廷的直接借记可用性。