跳转到主要内容
POST
Create Conversion

授权

x-auth-token
string
header
必填

由 UQPay 提供的登录 API Token。

请求头

x-on-behalf-of
string

指定代表哪个子账户发起请求。应设为 account_id,可通过查询关联账户列表获取。如果省略或留空,请求将使用主账户执行。 更多信息参见关联账户

x-idempotency-key
string<uuid>
必填

用于保持操作幂等性的唯一标识符(UUID),确保同一操作的重复执行不会产生意外影响或重复。它有助于在网络错误、重试或失败时保持数据一致性。

请求体

application/json
quote_id
string
必填

报价的唯一 UUID 标识符。

示例:

"784832f7-1f8a-4b08-ac2a-8719b5b2a590"

sell_currency
string
必填

币种代码 ISO_4217

示例:

"USD"

buy_currency
string
必填

币种代码 ISO_4217

示例:

"SGD"

conversion_date
string
必填

指定将执行换汇的日期。该日期必须是有效的可换汇日期。

仅支持当前日历日期 —— 不允许过去或未来的日期。 格式:YYYY-MM-DD

示例:

"2024-08-26"

sell_amount
string

换汇中卖出币种的金额。

示例:

"1000.00"

buy_amount
string

换汇中买入币种的金额。

示例:

"1000.00"

响应

200 - application/json

OK —— 成功获取 payout。

conversion_id
string
必填

换汇交易的唯一 UUID 标识符。

示例:

"784832f7-1f8a-4b08-ac2a-8719b5b2a590"

short_reference_id
string
必填

系统生成的用于标识该实体的编号。

示例:

"P220406-LLCVLRM"

sell_currency
string
必填

币种代码 ISO_4217

示例:

"USD"

sell_amount
string
必填

换汇中卖出币种的金额。

示例:

"10"

buy_currency
string
必填

币种代码 ISO_4217

示例:

"SGD"

buy_amount
string
必填

换汇中买入币种的金额。

示例:

"7.36"

created_date
string
必填

换汇交易发起时的时间戳。

示例:

"2024-08-22T17:12:58+08:00"

currency_pair
string
必填

该报价对应的货币对。货币对的方向尽可能遵循市场惯例。

示例:

"USDSGD"

reference
string
必填

系统生成的用于标识该实体的编号。

示例:

"XC240822-TXCRW2EI"

status
string
必填

该换汇交易的当前状态。有效值为:

  • PROCESSING:换汇请求正在由系统处理中。
  • AWAITING_FUNDS:系统正在等待源资金到位。
  • TRADE_SETTLED:已按约定汇率执行换汇。
  • FUNDS_ARRIVED:已收到兑换后的目标币种资金。
示例:

"AWAITING_FUNDS"