跳转到主要内容
POST
发起汇款,将资金从您的Localpayment账户结算到您自己的外部银行账户。
📌 电汇出与付款
  • 电汇出是结算/提现:资金从您的 Localpayment 账户转入您自己的外部银行账户。to 对象中定义的收款人必须是您本人,即与源账户相同的账户持有人,绝不能是第三方。
  • 付款是向最终收款人的支付(通常是您的客户)。如果您需要向第三方转账,请改用创建付款接口。
要发起汇款,请提供:
  • 目标银行信息(您自己的外部银行账户): 银行 name、swift、银行 address、accountName、accountNumber 和 beneficiaryAddress。账户持有人必须与作为源账户所有者的您一致。
  • 源 Localpayment 账户: 将从中扣除资金的 Localpayment 账户的 accountNumber。
  • 转账详情: amount、currency、country、设为 "WireOut" 的 transactionType、您的 externalId,以及可选的 comment。
成功后,Localpayment 会返回一个 internalId,您可以用它来跟踪电汇交易。您可以监控其状态,从 RECEIVED 到 Completed(资金已记入您的目标银行账户)或 Rejected。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求头

Authorization
string
必填

用于身份验证的 Bearer 访问令牌。该令牌可从获取访问令牌或刷新访问令牌endpoint 获取。

请求体

application/json
to
object
必填

电汇出账的收款银行账户。收款人必须是您本人,即与源账户相同的账户持有人。电汇出账是将资金结算到您自己的外部银行账户,而不是向第三方付款。如果收款人是您的客户,请使用创建付款。

amount
number
必填

交易金额。

country
string
必填

文件国家/地区。ISO 3166-1 alpha-3。对于稳定币电汇(USDC / USDT),请使用 GLO 或与目标钱包对应的 ISO alpha-3 国家代码。

currency
string
必填

货币代码。支持稳定币 USDC 和 USDT。

externalId
string
必填

系统生成的唯一标识符,用于跟踪交易(包含字母、数字和连字符)。我们建议使用 UUID4 以确保唯一性。

accountNumber
string
必填

Localpayment账号。

transactionType
string
必填

正在处理的交易类型。

comment
string

与交易相关的评论或备注。

响应

OK

transactionType
string

正在处理的交易类型。

externalId
string

系统生成的唯一标识符,用于跟踪交易(包含字母、数字和连字符)。我们建议使用 UUID4 以确保唯一性。

internalId
string

Localpayment交易标识符。

country
enum<string>

文件国家。ISO 3166-1 alpha-3。

可用选项:
ARG,
BOL,
BRA,
CHL,
COL,
CRI,
DOM,
ECU,
SLV,
GTM,
HND,
MEX,
PAN,
PRY,
PER,
URY,
GLO
currency
enum<string>
可用选项:
ARS,
BOB,
BRL,
CLP,
COP,
CRC,
DOP,
USD,
GTQ,
MXN,
PYG,
PEN,
UYU,
USDC,
USDT
clientCode
string

在Localpayment系统中分配给客户的唯一标识符。

creationDate
string

交易创建的日期和时间,采用 ISO 8601 格式。

errors
object[]

如果在交易过程中发生任何错误,则返回一个错误对象数组。

status
状态 · object

操作状态。

accountNumber
string

Localpayment账号。

amount
number

交易金额。

fees
object

有关所收取费用的详细信息。

localTaxes
object[]

地方税收信息。

withHoldings
object[]

预扣税信息。

comment
string

与交易相关的评论或备注。

最后修改于 2026年11月10日