跳转到主要内容
使用 Localpayment 的 API 通过钱包发送资金。本指南涵盖您需要了解的关于创建付款、处理响应、管理交易状态以及满足特定国家/地区要求的所有信息。 钱包付款允许您将资金直接发送到收款人的数字钱包。您可以通过以下两种方式发起转账:
  • Localpayment Business Portal:用户友好的界面,方便手动交易管理。
  • API 集成:通过程序化方式实现自动支付处理。
本指南重点介绍 API 实现,涵盖从初始化到完成的完整流程。

开始之前

请确保您已备好:

步骤 1:初始化支付交易

要创建银行转账付款,请向 Create a Payout endpoint 发送 POST 请求,并将 paymentMethod.type 设置为 Wallet。

endpoint

必需的标头

关键请求参数

该请求需要几个关键对象:

示例请求(玻利维亚)

curl

步骤 2:处理响应

成功响应

成功的响应应包含详细的交易信息和跟踪标识符:

关键响应字段

错误响应

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

步骤 3:跟踪交易状态

提交付款申请后,可通过以下方式监控付款进度:

Webhooks(推荐)

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

状态 API endpoint

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

Business Portal 视图

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

常用状态码

完整参考请查看我们的交易状态文档,了解所有状态代码。

第四步:交易审批

为了提高安全性,某些交易需要两人批准:
  1. 发起人:提交付款请求。
  2. 审批人:审核并确认交易。
该流程可通过Business Portal或 API endpoint进行管理。
安全须知审批要求有助于防止未经授权的交易,并确保符合当地法规。

各国具体要求

具体实施方案因国家/地区而异。未明确提及的国家/地区均遵循标准流程,无需特殊要求。集成前请仔细阅读以下要求:
YAPE 付款:
  • paymentMethod.code:设置为 0021。
  • beneficiary.bank.code:设置为 990。
  • beneficiary.bank.account.alias:必须包含收款人的电话号码,格式为 +591XXXXXXXX(完整国际格式)。
  • 请省略以下字段:beneficiary.bank.account.type 和 beneficiary.bank.account.number。


测试您的集成

沙盒环境

使用测试环境:

测试场景

请确认您的集成方案能够处理以下场景:
  1. 交易成功:标准支付流程
  2. 验证错误:无效的银行账户,缺少字段
  3. 处理延迟:需要时间处理的事务
  4. 交易失败:资金不足、收款人被冻结
  5. 状态更新:Webhook 处理和状态轮询

资源与后续步骤

利用这些关键资源,最大限度地提高您的集成成功率。

Webhook 集成

设置交易状态更新的实时通知。

报告 Business Portal

获取详细的分析、报告工具和对账功能。

交易监控

学习查询交易状态并实现全面跟踪。

API 参考

提供包含交互式示例的完整 endpoint 文档。

专业提示在部署到生产环境之前,务必先在我们的沙盒环境中测试您的工作流程。这可以确保您的错误处理、Webhook 处理和状态跟踪在所有场景下都能正常工作。

需要帮助吗?如果您遇到任何问题或需要集成方面的帮助,请联系我们的支持团队。

最后修改于 2026年11月10日