退款查询
API URL：https://mapi.yabandpay.com/Payments
Method：POST
POST data type：Json
| 参数 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| user | String | 收银员账号的UID | 必填 |
| sign | String | 签名 | 必填 |
| method | String | v3.QueryRefundOrder | 必填 |
| time | Long | 时间戳 | 必填 |
- 参数
| 参数 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| refund_id | String | YabandPay退款单号 | 必填 |
签名示例：
拼接为URL方式并排序后的字符串
"method=v3.QueryRefundOrder&time=1728566835&refund_id=3841510a-4d18-4a61-808d-431a45006de2&user=016683"
得到的 stringA 使用 secret_key做签名
得到的签名如下：
"8c15888bd5bcdaa643bf3d54daf5d642c6bab2defbb96017dd12f7c09b3fa498"
提交示例：
{
"user": "016683",
"sign": "8c15888bd5bcdaa643bf3d54daf5d642c6bab2defbb96017dd12f7c09b3fa498",
"method": "v3.QueryRefundOrder",
"time": 1728566835,
"data": {
"refund_id": "3841510a-4d18-4a61-808d-431a45006de2"
}
}
返回示例：
{
"status": true,
"code": "200",
"data": {
"transaction_id": "20240903153820059756",
"refund_id": "20240903154342497308",
"m_refund_id": null,
"refund_time": "1725349422",
"state": "refunded",
"refund_amount": "0.01",
"refund_currency": "EUR",
"refund_description": "gary",
"notify_url": "null",
"demo": "",
"settlement_refund_amount": "0.01",
"settlement_refund_currency": "EUR",
"merchant_cost": "0.1",
"yb_transaction_id": "c07859aa-3d12-69d4-ef2f-a9556d9c4d33"
},
"message": ""
}
更多信息：
返回结果：
若调用成功，则返回
"status": true若调用失败，则返回
"status": fales
退款状态：
| Code | State | Message |
|---|---|---|
| 20 | to-be-approval | 等待管理员批准。 |
| 21 | refund pending | 当前余额不足，余额充足时自动提交退款。 |
| 22 | refund processing | 退款请求已经提交，系统正在处理中。 |
| 23 | refunded | 退款已经成功完成。 |
| 24 | refund failed | 退款失败，请再次尝试。 |
| 25 | refund error | 退款失败，请联系我们在线客服。 |
| 26 | refund cancelled | 退款订单已经被取消。 |