跳转到主要内容
POST
Create Conversion

授权

x-auth-token
string
header
必填

UQPAY 提供的用于登录的 API Token。

请求头

x-on-behalf-of
string

指定代表哪个子账户发起请求。应设置为 account_id,可通过 List Connected Accounts 接口获取。若省略或为空,则请求以主账户身份执行。 更多信息参见 Connected Accounts。

x-idempotency-key
string<uuid>

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

请求体

application/json
quote_id
string
必填

Create Quote 返回的报价 ID。先获取新报价,并在 valid_to 到期前使用其币种和金额;不要重用示例报价 ID。

示例:

"44903b33-40ea-41cd-8e50-a4050e3e37ce"

sell_currency
string
必填

卖出币种

示例:

"USDT"

sell_amount
string
必填

卖出金额

示例:

"1"

buy_currency
string
必填

买入币种

示例:

"USD"

buy_amount
string
必填

买入金额

示例:

"0.99"

reason
string

交易备注

示例:

"Sandbox contract regression"

响应

200 - application/json

成功执行兑换

code
integer
必填
示例:

200

message
string
必填
示例:

"Success"

data
object
必填

创建兑换的响应数据(4.3.2)