开始之前
请确保您已备好:API凭证
用于身份验证的有效 API 凭据和访问令牌。
账户设置
为您的目标国家/地区正确设置账户并进行业务验证。
IP白名单
将服务器 IP 地址加入 API 访问白名单。
Webhook endpoint
设置 webhook URL 以接收付款通知。
工作原理
该流程与标准 CVU 虚拟账户在一个关键方面有所不同:每笔付款都会分配一个与特定金额绑定的 CVU。- 您的系统使用
paymentMethod.code: "1060"和预期金额调用POST /api/payin/。 - Localpayment 会返回一个唯一的 CVU、收款人银行详细信息和到期日期。
- 您需要向付款人显示 CVU、确切金额和到期期限。
- 付款人通过其银行应用程序或钱包向 CVU 发起银行转账。
- 当转账金额在到期前准确到达时,Localpayment 会确认付款并向您的系统发送 webhook。
步骤 1:创建支付意图
向创建 Payin endpoint 发送POST 请求。
请求
示例请求
成功响应
关键响应字段
错误响应
步骤二:向付款人展示付款说明
收到回复后,请向付款方出示以下内容:- CVU:来自
wireInstructions.beneficiary.bank.account.number的值 - 金额:您请求中的确切金额。付款人必须转出这一精确数额。
- 有效期:来自
date.expirationDate的截止时间 - 收款人名称:来自
wireInstructions.beneficiary.name的值(Localpayment S.R.L. 为已注册的账户持有人)
步骤三:处理付款通知
与标准虚拟账户(仅在付款到账时才会收到 webhook)不同,意图支付会触发两个 webhook 事件:- 创建通知(
INPROGRESS):在创建支付意图时立即触发,其wireInstructions中包含分配的 CVU 和到期日期。您的系统可以据此确认 CVU 分配。 - 完成通知(
COMPLETED):当付款人的转账被处理且在到期前收到确切金额时触发。
完成通知(COMPLETED)
在 Stage 环境中测试
使用模拟虚拟账户支付endpoint 在 Stage 环境中进行端到端测试,而无需进行真正的银行转账。 使用paymentMethod.code: "1060" 以及创建响应中返回的相同 externalId 来模拟一笔成功的付款。
演示

后续步骤
接收付款通知
配置您的 webhook endpoint,并了解如何验证和处理虚拟账户付款的 PayIn 通知。
获取交易状态
轮询交易状态 endpoint 以检查支付意图的当前状态。
模拟付款
在 Stage 环境中进行端到端集成测试,无需进行真实的银行转账。
虚拟账户概览
了解所有虚拟账户产品及其应用场景。

