跳转到主要内容
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"