- Localpayment Business Portal:用户友好的界面,方便手动交易管理。
- API 集成:通过程序化方式实现自动支付处理。
开始之前
请确保您已备好:步骤 1:初始化支付交易
要创建银行转账付款,请向 Create a Payout endpoint 发送POST 请求,并将 paymentMethod.type 设置为 Wallet。
endpoint
必需的标头
关键请求参数
该请求需要几个关键对象:示例请求(玻利维亚)
curl
步骤 2:处理响应
成功响应
成功的响应应包含详细的交易信息和跟踪标识符:关键响应字段
错误响应
请求失败时,您将收到详细的错误信息:步骤 3:跟踪交易状态
提交付款申请后,可通过以下方式监控付款进度:Webhooks(推荐)
交易状态变更时接收实时通知。最适用于生产环境。
状态 API endpoint
以编程方式查询交易状态。可用于轮询或恢复丢失的 webhook 通知。
Business Portal 视图
用于监控交易的可视化界面。非常适合人工监督和详细的交易分析。
常用状态码
完整参考请查看我们的交易状态文档,了解所有状态代码。
第四步:交易审批
为了提高安全性,某些交易需要两人批准:- 发起人:提交付款请求。
- 审批人:审核并确认交易。
安全须知审批要求有助于防止未经授权的交易,并确保符合当地法规。
各国具体要求
具体实施方案因国家/地区而异。未明确提及的国家/地区均遵循标准流程,无需特殊要求。集成前请仔细阅读以下要求:- 玻利维亚
- 秘鲁
- 哥斯达黎加
YAPE 付款:
paymentMethod.code:设置为 0021。beneficiary.bank.code:设置为 990。beneficiary.bank.account.alias:必须包含收款人的电话号码,格式为 +591XXXXXXXX(完整国际格式)。- 请省略以下字段:
beneficiary.bank.account.type和beneficiary.bank.account.number。
测试您的集成
沙盒环境
使用测试环境:测试场景
请确认您的集成方案能够处理以下场景:- 交易成功:标准支付流程
- 验证错误:无效的银行账户,缺少字段
- 处理延迟:需要时间处理的事务
- 交易失败:资金不足、收款人被冻结
- 状态更新:Webhook 处理和状态轮询
资源与后续步骤
利用这些关键资源,最大限度地提高您的集成成功率。Webhook 集成
设置交易状态更新的实时通知。
报告 Business Portal
获取详细的分析、报告工具和对账功能。
交易监控
学习查询交易状态并实现全面跟踪。
API 参考
提供包含交互式示例的完整 endpoint 文档。
专业提示在部署到生产环境之前,务必先在我们的沙盒环境中测试您的工作流程。这可以确保您的错误处理、Webhook 处理和状态跟踪在所有场景下都能正常工作。
需要帮助吗?如果您遇到任何问题或需要集成方面的帮助,请联系我们的支持团队。

