换汇结果查询
请求地址
[POST] /v1/mid-open-api/exchange/query需要验证签名
接口描述
通过换汇申请订单号或者平台返回订单号查询换汇结果
请求头
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | string | M | access_token |
| Content-Type | string | M | application/json |
请求参数
| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string(64) | M | 客户ID |
| order_id | string(64) | C | 平台订单ID , 与客户订单号二选一 |
| partner_order_id | string(64) | C | 客户订单号 , 与平台订单号二选一 |
返回响应
| Parameter | Type | Required | Description |
|---|---|---|---|
| partner_order_id | string(64) | M | 客户订单号 |
| order_id | string(64) | M | 平台订单号 |
| client_id | string(64) | M | 客户ID |
| status | string(64) | M | 状态 ，见换汇申请文档 |
| sell_currency | string(3) | M | 卖出币种 |
| buy_currency | string(3) | M | 买入币种 |
| sell_amount | decimal(18,2) | M | 卖出金额 |
| buy_amount | decimal(18,2) | M | 买入金额 |
| create_time | long | M | 下单时间 |
| rate | decimal(18,9) | M | 汇率 |
| finish_time | long | C | 完成时间，状态为终态时有值 |
| fail_reason | string | C | 失败原因，状态为失败时有值 |
返回示例
- 成功
- 失败
{
"code": 200,
"message": "SUCCESS",
"data": {
"rate": 0.912659,
"status": "PROCESSING",
"created": 1692176037000,
"finish_time": null,
"order_id": "OE2308160000364769",
"client_id": "IT8623081103775418152",
"partner_order_id": "test_b1988c893f1f",
"sell_currency": "USD",
"buy_currency": "EUR",
"sell_amount": 52.08,
"buy_amount": 56.33,
"fail_reason": null
}
}
{
"code": 900002,
"message": "partner_order_id and order_id have at least one",
"data": null
}
错误码
| 错误码 | 描述 | 解决方案 |
|---|---|---|
| 900000 | system error | 系统错误，请联系PingPong技术人员核查 |
| 900002 | illegal param | 参数有误，请根据提示更正信息 |
| 900004 | order not exist | 换汇申请不存在，请核对后再发起 |