退款结果查询
需要验证签名
接口描述
查询已发起的入账退款结果
请求头
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | string | M | access_token |
| Content-Type | string | M | application/json |
请求参数
| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string(64) | M | 注册PingPong返回的客户ID |
| partner_order_id | string(64) | C | 合作伙伴退款时的请求单号,transaction_id为空时必传。 |
| transaction_id | string(64) | C | 来账流水单号,partner_order_id为空时必传。 |
返回响应
| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string(64) | M | 注册PingPong返回的客户ID |
| partner_order_id | string(64) | M | 合作伙伴退款时的请求单号 |
| transaction_id | string(64) | M | 来账流水单号 |
| status | string(64) | M | 状态 PROCESSING、SUCCESS、FAILED |
| currency | string(64) | O | 退款币种,退款状态SUCCESS时返回 |
| amount | number | O | 退款金额,退款状态SUCCESS时返回 |
| finish_time | long | O | 退款完成时间戳,退款状态SUCCESS时返回 |
| fail_reason | string(255) | O | 失败原因，状态为FAILED时返回 |
返回示例
- 成功
- 失败
{
"code": 200,
"message": "成功",
"data": {
"partner_order_id": "Refund2023080002",
"client_id": "IT8623081809128663724",
"transaction_id": "MTX2308223195534120",
"status": "SUCCESS",
"fail_reason": null,
"currency": "USD",
"amount": 6425.00,
"finish_time": 1692759012000
},
}
{
"code": 900002,
"data": null,
"message": "client_id is empty"
}
错误码
| 返回码 | 描述 | 解决方案 |
|---|---|---|
| 900000 | system error | 系统错误，请联系PingPong技术人员核查 |
| 900002 | illegal param | 参数有误，请根据提示更正信息 |