Skip to content

汇兑下单 ​

  • 方法:POST
  • 路径:/coin/v1/exchange/confirm
  • 参数:JSON Body

请求字段 ​

字段类型必填约束说明
quote_idstring是非空;须原样回传未过期的询价结果询价 ID(询价接口返回的 quote_id)
trade_snstring是长度 1~255商户订单号(同商户下唯一)
pay_amountdouble是> 0支付金额(询价接口返回的 pay_amount)
receive_amountdouble是> 0;精度见 货币到账金额(询价接口返回的 receive_amount)
pay_currencystring是见 货币支付货币(询价接口返回的 pay_currency)
receive_currencystring是见 货币收到货币(询价接口返回的 receive_currency)
notify_urlstring否http/https;0~255异步通知地址;空则不发送,见 汇兑订单

响应字段(data) ​

字段类型说明
trade_snstring商户订单号
order_nostring平台订单号
pay_currencystring支付货币
receive_currencystring收到货币
pay_amountdouble支付金额
receive_amountdouble兑换金额
ratedouble汇率
statusstring订单状态,下单成功固定为 PENDING;见 汇兑订单状态
created_atstring创建时间,RFC3339(含时区)

成功响应示例 ​

json
{
  "status": 200,
  "msg": "SUCCESS",
  "data": {
    "trade_sn": "ORD-001",
    "order_no": "O202606160001",
    "pay_currency": "BRL",
    "receive_currency": "USDT",
    "pay_amount": 543.21,
    "receive_amount": 100,
    "rate": 5.4321,
    "status": "PENDING",
    "created_at": "2026-06-16T16:00:10+08:00"
  }
}