查询提现/付款交易详情
需要验证签名
接口描述
该接口用于查询提现/付款交易单详情信息，包括交易账户明细和支付明细。
提示
- 交易单详情信息查询主要包含订单状态、支付成功金额、支付失败金额以及订单完成时间等基本信息，以及交易订单对应付款账户详情和交易订单对应支付单详情。
- 交易订单对应付款账户详情指一笔交易所包含的所有付款账户明细（即账户流水信息）。
- 交易订单对应支付单详情指一笔交易所包含的所有支付订单明细（即拆单后实际代发详情）。
请求头
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | string | M | access_token |
| Content-Type | string | M | application/json |
请求参数
| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string(64) | M | 客户号 |
| partner_order_id | string(64) | M | 提现/付款请求单号 |
返回响应
| Parameter | Type | Required | Description |
|---|---|---|---|
| order_id | string(64) | M | PingPong唯一单号 |
| client_id | string(64) | M | 客户号 |
| partner_order_id | string(64) | M | 交易请求单号 |
| complete_flag | boolean | M | 交易完成标识：false-否，true-是 |
| receive_target_amount | decimal(18,2) | O | 支付成功目标金额【支付成功目标金额累加结果】 |
| failed_target_amount | decimal(18,2) | O | 支付失败目标金额【支付失败目标金额累加结果】 |
| target_currency | string(3) | M | 支付目标币种 |
| create_time | long | M | 交易订单申请时间 |
| finish_time | long | O | 交易订单完成时间 |
| status | string(16) | M | 交易订单状态: PROCESSING-处理中, FAILED-失败, SUCCESS-成功, PARTIAL_SUCCESS-部分成功 |
| pay_account_detail | object | O | 交易订单对应付款账户详情【交易订单非终态返回空】 |
| pay_distribute_detail | object | O | 交易订单对应支付单详情【交易订单非终态或未执行代发时返回空】 |
pay_account_detail
| Parameter | Type | Required | Description |
|---|---|---|---|
| account_id | string(64) | M | 交易账户ID |
| account_type | string(32) | M | 交易账户类型 |
| pay_currency | string(8) | M | 交易账户币种 |
| pay_amount | decimal(18,2) | M | 交易账户支出金额 |
| fee_amount | decimal(18,2) | M | 交易账户手续费金额 |
| pay_actual_amount | decimal(18,2) | M | 交易账户扣除手续费应到账金额【非换汇金额】 |
pay_distribute_detail
| Parameter | Type | Required | Description |
|---|---|---|---|
| distribute_id | string(64) | M | 支付单号 |
| target_currency | string(8) | M | 目标币种 |
| target_amount | decimal(18,2) | M | 目标金额 |
| status | string(16) | M | 支付状态: SUCCESS-成功，FAILED-失败 |
| finish_time | long | M | 支付完成时间 |
| error_msg | string(255) | O | 失败描述 |
| refund_reason | string(255) | O | 退票原因 |
| refund_flag | boolean | M | 退票标识 false-否，true-是 |
返回示例
- 成功
- 失败
{
"code": 200,
"data": {
"order_id": "20220620151628",
"client_id": "20220620151628",
"partner_order_id": "PO20220620151628",
"complete_flag": true,
"receive_target_amount": 100.00,
"failed_target_amount": 0,
"target_currency": "USD",
"create_time": 1690899160,
"finish_time": 1690899160,
"status": "SUCCESS",
"pay_account_detail": {
"account_id": "AO20220620151628",
"account_type": "OPEN_WALLET",
"pay_currency": "USD",
"pay_amount": 100.00,
"fee_amount": 0,
"pay_actual_amount": 100.00
},
"pay_distribute_detail": {
"distribute_id": "PDO20220620151628",
"target_currency": "USD",
"target_amount": 100.00,
"status": "SUCCESS",
"finish_time": 1690899160,
"refund_flag": false
}
},
"message": "SUCCESS"
}
```json
{
"code": 900003,
"data": null,
"message": "订单不存在"
}
```
错误码
| 返回码 | 描述 | 解决方案 |
|---|---|---|
| 900000 | system error | 系统错误，请联系PingPong人员核查 |
| 900002 | illegal param | 参数错误，请根据提示更正信息 |
| 900004 | order not exist | 订单ID不存在，请核实 |