跳转到主要内容
使用我们的 API 向 Localpayment 通知一笔收到的电汇,以结算您的账户余额。本指南将引导您完成发起通知、处理 API 响应以及跟踪交易状态的全过程。 对于以法定货币(例如 USD、ARS、MXN)进行的交易,您需要通知我们收到汇款。您可以通过以下方式完成此操作:
重要的Wire In 通知流程不适用于 稳定币。请改为遵循稳定币 Wire In 流程。
本指南涵盖从通知到最终结算的完整 API 工作流程。

开始之前

在通知 Wire In 之前,请确保您已具备:
  • 电汇凭证:外部转账的证明。
  • 有效的 API 凭据:具有相应的授权权限。
  • 完整的交易详情:所有必需的交易信息。

API endpoint

要通知结算,请向 Create Wire In endpoint 发送 POST 请求。

endpoint

验证

请在 Authorization 标头中包含您的访问令牌:

关键请求参数

该请求需要几个关键参数:

示例请求(阿根廷)

curl

响应处理

成功响应

Wire In 请求被接受后,您将收到一条详细的响应:

关键响应字段

错误响应

验证错误示例


跟踪交易状态

提交 Wire In 后,可通过以下方式监控其进度:

Webhooks(推荐)

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

状态 API endpoint

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

Business Portal 视图

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

常用状态码

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

安全建议

  • API 请求务必使用 HTTPS
  • 安全存储访问令牌(切勿存储在客户端代码中)
  • 实施适当的错误处理和日志记录
  • 在发送请求之前验证所有输入数据

资源与后续步骤

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

Webhook 集成

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

报告 Business Portal

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

交易监控

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

API 参考

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

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

需要帮助吗?如果您遇到任何问题或需要集成方面的帮助,请联系我们的支持团队。
最后修改于 2026年11月10日