跳转到主要内容
Localpayment 允许您通过 API 集成和 Business Portal 界面,从您的 Localpayment 账户提取资金并存入您自己的外部银行账户。本指南涵盖用于资金结算的完整 Wire Out 工作流程,详细介绍授权流程、API 实现和状态跟踪。
Wire Out 与付款Wire Out 是结算/提款:资金从您的 Localpayment 账户转移到您自己的外部银行账户,绝不会转移到第三方。付款是向最终收款人(通常是您的客户)支付款项。如果您需要向第三方汇款,请改用创建付款endpoint。

开始之前

请确保您已备好:

API凭证

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

账户设置

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

IP白名单

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

Webhook endpoint

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

额外的 Wire Out 要求:

  • 您的 Localpayment 账户中需有充足的可用余额。可在余额报告中查看,或通过预计余额报告估算即将到账的资金。
  • 具有足够权限进行 Wire Out 授权的用户角色(请参阅有关角色和权限的文档)。
  • 外部银行账户详情(SWIFT 代码、账号、收款人信息)。

实施指南

Localpayment 提供两种处理 Wire Out 的方法:用于自动处理的 API 集成,以及用于手动操作的 Business Portal。

API Wire Out 处理

通过 REST API 以编程方式发起 Wire Out 交易, 用于自动化结算工作流程和系统集成。

Business Portal Wire Out 处理

通过 Localpayment Business Portal 手动处理 Wire Out 指令, 提供可视化界面和分步指引。

步骤 1:通过 API 处理 Wire Out

要通过 API 发起 Wire Out 交易,请向 Wire Out endpoint 发送 POST 请求。

关键请求参数

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

示例请求

curl
查看请求中所有可用的参数。

步骤 2:处理响应

成功响应

成功发起的 Wire Out 会返回交易详情及初始状态:

关键响应字段

错误响应

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

步骤 3:追踪 Wire Out 状态

发起 Wire Out 后,可通过以下方法监控其进度:

Webhooks(推荐)

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

状态 API endpoint

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

Business Portal 视图

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

常见 Wire Out 状态代码

完成通知当交易达到 Completed 或 Rejected 状态时,您将收到电子邮件通知,无论交易是通过 API 还是 Business Portal 发起。对于加密货币 Wire Out 交易(USDC/USDT),Completed webhook 回调还会包含区块链交易哈希(hash 字段),以便您在区块浏览器中独立验证付款。此字段不适用于法币 Wire Out——完整的负载示例请参阅 Webhooks。

Business Portal Wire Out 处理

Wire Out 交易也可以通过 Localpayment Business Portal 界面进行处理。这种方法提供了可视化的资金转账管理工作流程,尤其适用于:
  • 无需 API 自动化的一次性结算**。
  • 通过可视化授权工作流程进行管理监督**。
  • 无需开发资源即可进行快速资金转账。
有关通过 Business Portal 处理 Wire Out 交易的详细说明,包括分步指南和界面演示,请参阅Business Portal Wire Out 指南。

测试您的集成

测试场景

请确认您的集成方案能够处理以下场景:
  1. 成功的 Wire Out:使用有效参数和充足余额处理转账。
  2. 资金不足:尝试转账金额超过账户余额。
  3. 无效的银行信息:请使用错误的 SWIFT 代码或账号进行测试。
  4. 授权工作流程:验证待审批授权状态和审批流程。

后续步骤

查看交易状态

使用交易状态 API 查看 Wire Out 交易的 当前状态。

配置 Webhook

设置 Webhook 以接收 Wire Out 状态变更的 实时通知。
最后修改于 2026年11月10日