Create Quote
Conversion
Create Quote
创建一个用于换汇的新 FX 报价。返回的汇率已包含 UQPAY 的加价,反映报价有效期内适用的最终汇率。
使用说明
- 在执行换汇或跨币种 payout 前需要先获取报价。
- 生成的报价必须在其有效期(75 秒)内使用,超时后如有需要须重新请求报价。
- 同时指定
buy_currency和sell_currency,但buy_amount与sell_amount只定义其中之一。所定义的金额代表交易(固定)的一方,另一方金额将根据 UQPAY 的汇率自动计算。 - 使用特定
transaction_type创建的报价只能用于对应的操作,不允许混用。- 换汇报价必须配合创建换汇使用。
- payout 报价必须配合创建 Payout 使用。
POST
Create Quote
授权
由 UQPay 提供的登录 API Token。
请求头
用于保持操作幂等性的唯一标识符(UUID),确保同一操作的重复执行不会产生意外影响或重复。它有助于在网络错误、重试或失败时保持数据一致性。
请求体
application/json
卖出的币种。
在跨币种 payout 场景下,这应为汇款方账户中的币种。
示例:从 USD 账户向受益人付出 SGD,则设置 sell_currency = USD。
示例:
"USD"
买入的币种。
在跨币种 payout 场景下,这应为受益人将收到的币种。
示例:从 USD 账户向受益人付出 SGD,则设置 buy_currency = SGD。
示例:
"SGD"
指定将执行换汇的预定日期。该日期应为有效的工作日。
示例:
"2024-08-26"
sell_currency 的金额。
示例:
"1000.00"
buy_currency 的金额。
示例:
"1000.00"
交易类型。
conversion:默认值。仅用于换汇。payout:仅用于跨币种 payout。
可用选项:
conversion, payout 
