跳转到主要内容
GET
Retrieve Conversion

授权

x-auth-token
string
header
必填

由 UQPAY 提供的登录 API Token。

请求头

x-on-behalf-of
string

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

路径参数

id
string<uuid>
必填

资源的通用唯一标识符(UUID v4)。

示例:

"b3d9d2d5-4c12-4946-a09d-953e82sed2b0"

响应

200 - application/json

OK —— 成功获取换汇。

account_name
string
必填

与该账户关联的客户名称。

示例:

"UQPAY"

conversion_id
string
必填

换汇交易的唯一 UUID 标识符。

示例:

"b3d9d2d5-4c12-4946-a09d-953e82sed2b0"

short_reference_id
string
必填

系统生成的用于标识该实体的编号。

示例:

"P220406-LLCVLRM"

creator
string
必填

发起该换汇交易的实体。

示例:

"UQPAY"

client_rate
string
必填

该交易适用的汇率。

示例:

"1.355957"

buy_amount
string
必填

换汇中买入币种的金额。

示例:

"7.37"

buy_currency
string
必填

币种代码 ISO_4217。

示例:

"SGD"

sell_amount
string
必填

换汇中卖出币种的金额。

示例:

"10"

sell_currency
string
必填

币种代码 ISO_4217。

示例:

"USD"

create_time
string
必填

换汇交易发起时的时间戳。

示例:

"2024-08-22T17:12:58+08:00"

settle_time
string
必填

换汇交易成功结算时的时间戳。

示例:

"2024-08-22T17:13:00+08:00"

conversion_status
enum<string>
必填

该换汇交易的当前状态。

  • PROCESSING:换汇请求正在由系统处理中。
  • AWAITING_FUNDS:系统正在等待源资金到位。
  • TRADE_SETTLED:换汇已成功完成。这是成功终态。
  • FUNDS_ARRIVED:源资金已到位,可用于换汇。这是中间状态,不表示换汇已完成。
可用选项:
PROCESSING,
AWAITING_FUNDS,
TRADE_SETTLED,
FUNDS_ARRIVED
示例:

"FUNDS_ARRIVED"