跳转到主要内容
POST
使用批量货币兑换 API,在同一国家内的您自有多币种账户之间高效兑换资金。这非常适合管理国际业务的企业优化其内部资金管理。
重要
  • account.debited.amount:从源账户中扣除的金额。
  • account.credited.amount:划入目标账户的金额。 所提供字段的值必须大于 0。
想在执行交易前锁定汇率吗?使用货币兑换报价 API 为该货币对生成汇率报价。响应中包含 exchangeRateToken,请在您的外汇转换请求中传入该令牌以锁定该汇率。报价汇率在该令牌的 expirationDate 之前始终有效,可保护您和您的用户免受市场波动的影响。

授权

Authorization
string
header
必填

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

请求头

Authorization
string
必填

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

请求体

application/json
country
string
必填

处理该笔付款的国家/地区。

externalId
string
必填

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

exchangeRateToken
string
必填

由外汇服务提供的令牌,用于使用预先约定的汇率

account
object
必填

包含交易账户详细信息的对象。

响应

OK

transactionType
string

交易类型。对于货币兑换操作,此值为 CurrencyExchange。

externalId
string

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

internalId
string

Localpayment交易标识符。

country
string

处理交易的国家/地区。

currency
string

交易的原始货币。

exchangeRateToken
string

用于跟踪该交易汇率的唯一标识符。

clientCode
string

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

creationDate
string

交易创建的日期和时间。

errors
object[]

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

status
object
account
object
最后修改于 2026年11月10日