Create Conversion
Conversion
Create Conversion
在你的 UQPAY 账户余额内创建一笔新的换汇。这允许你以可用汇率将一种币种兑换为另一种币种。
使用说明
- 如果使用预生成的报价,请提供有效的
quote_id。关键的换汇参数(buy_currency、sell_currency、conversion_date)必须与报价详情一致。 - 同时指定
buy_currency和sell_currency,但buy_amount与sell_amount只定义其中之一。所定义的金额代表交易(固定)的一方,另一方金额将根据 UQPAY 的汇率自动计算。
POST
Create Conversion
授权
由 UQPay 提供的登录 API Token。
请求头
用于保持操作幂等性的唯一标识符(UUID),确保同一操作的重复执行不会产生意外影响或重复。它有助于在网络错误、重试或失败时保持数据一致性。
请求体
application/json
报价的唯一 UUID 标识符。
示例:
"784832f7-1f8a-4b08-ac2a-8719b5b2a590"
指定将执行换汇的日期。该日期必须是有效的可换汇日期。
仅支持当前日历日期 —— 不允许过去或未来的日期。
格式:YYYY-MM-DD。
示例:
"2024-08-26"
换汇中卖出币种的金额。
示例:
"1000.00"
换汇中买入币种的金额。
示例:
"1000.00"
响应
200 - application/json
OK —— 成功获取 payout。
换汇交易的唯一 UUID 标识符。
示例:
"784832f7-1f8a-4b08-ac2a-8719b5b2a590"
系统生成的用于标识该实体的编号。
示例:
"P220406-LLCVLRM"
换汇中卖出币种的金额。
示例:
"10"
换汇中买入币种的金额。
示例:
"7.36"
换汇交易发起时的时间戳。
示例:
"2024-08-22T17:12:58+08:00"
该报价对应的货币对。货币对的方向尽可能遵循市场惯例。
示例:
"USDSGD"
系统生成的用于标识该实体的编号。
示例:
"XC240822-TXCRW2EI"
该换汇交易的当前状态。有效值为:
PROCESSING:换汇请求正在由系统处理中。AWAITING_FUNDS:系统正在等待源资金到位。TRADE_SETTLED:已按约定汇率执行换汇。FUNDS_ARRIVED:已收到兑换后的目标币种资金。
示例:
"AWAITING_FUNDS"

