跳转到主要内容
POST
Create Transfer

授权

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
currency
string
必填

本次转出/转入的钱包币种

示例:

"USD"

amount
string
必填

本次转出/转入的金额

示例:

"100.50"

type
integer
必填

转出:4001;转入:4000

示例:

4001

reason
string

交易备注

示例:

"Business transfer"

响应

200 - application/json

成功创建转账

code
integer
必填
示例:

200

message
string
必填
示例:

"Success"

data
object
必填

创建转账的响应(第 4.2.1 节)