inquireRefund
POST
: /amsin/api/v1/business/inquireRefund
在退款完成之后,集成商可调用此接口来查询退款结果。
接口结构
万里汇接口报文结构包括:请求头,请求体。关于头信息,详见:
请求参数
字段名 | 数据类型 | 是否必传 | 描述 |
refundRequestIds | 列表<字符串> | 是(有条件) | 由集成商指定的唯一退款ID。 更多信息:
|
refundIds | 列表<字符串> | 是(有条件) | 万里汇受理退款的唯一单号ID。 更多信息:
|
响应参数
字段名 | 数据类型 | 是否必传 | 描述 |
result | Result对象 | 是 | 本次接口调用的结果。 |
refundInformation | 数组<RefundInfo>对象 | 是 | 退款信息。 |
结果码
resultCode | resultStatus | resultMessage | 处理建议 |
SUCCESS | S | Success | |
PARAM_ILLEGAL | F | Illegal parameters exist. For example, a non-numeric input, or an invalid date. | 参考API文档页面以确认请求头和传参是否正确 |
UNKNOWN_EXCEPTION | U | API failed due to unknown reason. | 服务器忙。若稍后重试问题依旧,联系万里汇技术支持以解决问题 |
REFUND_ORDER_NOT_EXIST | F | The refund order does not exist. | 退款单不存在,确认退款已发起后重试。 |
范例
请求
copy
{
"refundIds":["202311271540108013001888202057*****"]
}
或者
copy
{
"refundRequestIds":["yidong_refund_requestId_17010*****"]
}
响应
copy
{
"refundInformation": [
{
"payToId": "202311271540108001001888202063*****",
"refundAmount": {
"currency": "USD",
"value": "400"
},
"refundId": "202311271540108013001888202057*****",
"refundOrderDetails": [
{
"paymentMethodType": "WALLET_WF",
"refundActualAmount": {
"currency": "USD",
"value": "400"
}
},
{
"fundType": "FEE",
"paymentMethodType": "WALLET_WF",
"refundActualAmount": {
"currency": "USD",
"value": "1"
}
}
],
"refundRequestId": "yidong_refund_requestId_17010*****",
"refundStatus": "SUCCESS",
"refundTime": "2023-11-27T05:59:36-08:00"
}
],
"result": {
"resultCode": "SUCCESS",
"resultMessage": "success.",
"resultStatus": "S"
}
}