跳转到主要内容
为阿根廷的每笔交易分配一个CVU。只有付款人在有效期结束前转账金额与交易金额完全一致,付款才能确认。 具有支付意图功能的虚拟账户会为每笔交易分配一个 CVU(统一虚拟账户),该 CVU 与特定金额和有效期相关联。与接受任何存款的标准虚拟账户不同,该产品仅在付款人在有效期前转账金额与指定金额完全一致时才会确认付款。

开始之前

请确保您已备好:

API凭证

用于身份验证的有效 API 凭据和访问令牌。

账户设置

为您的目标国家/地区正确设置账户并进行业务验证。

IP白名单

将服务器 IP 地址加入 API 访问白名单。

Webhook endpoint

设置 webhook URL 以接收付款通知。

工作原理

该流程与标准 CVU 虚拟账户在一个关键方面有所不同:每笔付款都会分配一个与特定金额绑定的 CVU。
  1. 您的系统使用 paymentMethod.code: "1060" 和预期金额调用 POST /api/payin/。
  2. Localpayment 会返回一个唯一的 CVU、收款人银行详细信息和到期日期。
  3. 您需要向付款人显示 CVU、确切金额和到期期限。
  4. 付款人通过其银行应用程序或钱包向 CVU 发起银行转账。
  5. 当转账金额在到期前准确到达时,Localpayment 会确认付款并向您的系统发送 webhook。

步骤 1:创建支付意图

向创建 Payin endpoint 发送 POST 请求。

请求

示例请求

成功响应

关键响应字段

错误响应


步骤二:向付款人展示付款说明

收到回复后,请向付款方出示以下内容:
  • CVU:来自 wireInstructions.beneficiary.bank.account.number 的值
  • 金额:您请求中的确切金额。付款人必须转出这一精确数额。
  • 有效期:来自 date.expirationDate 的截止时间
  • 收款人名称:来自 wireInstructions.beneficiary.name 的值(Localpayment S.R.L. 为已注册的账户持有人)

如果付款人转账金额不同,则该转账将作为标准虚拟账户入账,并且不会确认付款意图。

步骤三:处理付款通知

与标准虚拟账户(仅在付款到账时才会收到 webhook)不同,意图支付会触发两个 webhook 事件:
  1. 创建通知(INPROGRESS):在创建支付意图时立即触发,其 wireInstructions 中包含分配的 CVU 和到期日期。您的系统可以据此确认 CVU 分配。
  2. 完成通知(COMPLETED):当付款人的转账被处理且在到期前收到确切金额时触发。

完成通知(COMPLETED)


在 Stage 环境中测试

使用模拟虚拟账户支付endpoint 在 Stage 环境中进行端到端测试,而无需进行真正的银行转账。 使用 paymentMethod.code: "1060" 以及创建响应中返回的相同 externalId 来模拟一笔成功的付款。

演示


后续步骤

接收付款通知

配置您的 webhook endpoint,并了解如何验证和处理虚拟账户付款的 PayIn 通知。

获取交易状态

轮询交易状态 endpoint 以检查支付意图的当前状态。

模拟付款

在 Stage 环境中进行端到端集成测试,无需进行真实的银行转账。

虚拟账户概览

了解所有虚拟账户产品及其应用场景。

最后修改于 2026年11月10日