跳转到主要内容
POST
Create Quote

授权

x-auth-token
string
header
必填

由 UQPay 提供的登录 API Token。

请求头

x-on-behalf-of
string

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

x-idempotency-key
string<uuid>
必填

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

请求体

application/json
sell_currency
string
必填

卖出的币种。

在跨币种 payout 场景下,这应为汇款方账户中的币种。 示例:从 USD 账户向受益人付出 SGD,则设置 sell_currency = USD

示例:

"USD"

buy_currency
string
必填

买入的币种。

在跨币种 payout 场景下,这应为受益人将收到的币种。 示例:从 USD 账户向受益人付出 SGD,则设置 buy_currency = SGD

示例:

"SGD"

conversion_date
string
必填

指定将执行换汇的预定日期。该日期应为有效的工作日。

示例:

"2024-08-26"

sell_amount
string

sell_currency 的金额。

示例:

"1000.00"

buy_amount
string

buy_currency 的金额。

示例:

"1000.00"

transaction_type
enum<string>

交易类型。

  • conversion:默认值。仅用于换汇。
  • payout:仅用于跨币种 payout。
可用选项:
conversion,
payout

响应

200 - application/json

OK —— 成功获取 payout。

sell_currency
string
必填

币种代码 ISO_4217

示例:

"USD"

sell_amount
string
必填

sell_currency 的金额。

示例:

"100"

buy_currency
string
必填

币种代码 ISO_4217

示例:

"SGD"

buy_amount
string
必填

buy_currency 的金额。

示例:

"135.02"

quote_price
object
必填