查询提现/付款交易结果
需要验证签名
接口描述
该接口用于查询提现/付款交易单信息，支付详情信息请调用提现/付款支付交易明细查询。
提示
- 交易单信息查询主要包含订单状态、支付成功金额、支付失败金额以及订单完成时间等基本信息。
- 交易完成标识主要是针对一笔交易可能多笔支付的场景（目前仅当目标币种为CNY时可能会出现，多笔支付说明请参考），该标识为true，表示所有支付单全部完成。
- 支付成功或失败目标金额指每笔交易单对应的支付单分别根据代发结果成功或失败累加的结果【注：拆单说明请见申请提现接口提示6】。
- 订单完成时间指最后一笔支付单完成渠道的回调通知时间，可能晚于资金实际到账时间，交易完成时返回。
- 失败描述仅针对一笔支付场景失败时返回（即非拆单情况）。
- 交易单状态FAILED-失败, SUCCESS-成功, PARTIAL_SUCCESS-部分成功均为终态，其中部分成功表示交易单拆分多笔支付单后有部分成功和部分失败的情况。
- 交易单风控审核状态: PROCESSING-审核处理中, APPROVED-审核通过, REJECTED-审核拒绝，DECLINED：审核打回待补充材料 。
请求头
| 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) | M | 支付成功目标金额【支付成功目标金额累加结果】 |
| failed_target_amount | decimal(18,2) | M | 支付失败目标金额【支付失败目标金额累加结果】 |
| target_currency | string(3) | M | 支付目标币种 |
| create_time | long | M | 交易订单申请时间 |
| finish_time | long | O | 交易订单完成时间 |
| error_msg | string(128) | O | 失败描述 |
| status | string(16) | M | 交易订单状态: PROCESSING-处理中, FAILED-失败, SUCCESS-成功, PARTIAL_SUCCESS-部分成功 |
| audit_status | string(32) | M | 交易订单风控审核状态: PROCESSING-处理中, APPROVED-通过, REJECTED-拒绝，RETURNED：打回待补充材料 |
返回示例
- 成功
- 失败
{
"code": 200,
"data": {
"order_id": "20220620151628",
"client_id": "20220620151628",
"partner_order_id": "PO20220620151628",
"complete_flag": true,
"receive_target_amount": 0.00,
"failed_target_amount": 100.00,
"target_currency": "USD",
"create_time": "",
"finish_time": 1690899160,
"error_msg": "渠道代发异常",
"status": "FAILED",
"audit_status": "APPROVED"
},
"message": "SUCCESS"
}
{
"code": 900003,
"data": null,
"message": "订单不存在"
}
错误码
| 返回码 | 描述 | 解决方案 |
|---|---|---|
| 900000 | system error | 系统错误，请联系PingPong人员核查 |
| 900002 | illegal param | 参数错误，请根据提示更正信息 |
| 900004 | order not exist | 订单ID不存在，请核实 |
更新日志
2024-04-01 接入交易审核功能
- 新增返回audit_status（风控审核状态）字段。