inquireRefund

POST: /amsin/api/v1/business/inquireRefund

需要签名验签

在退款完成之后,集成商可调用此接口来查询退款结果。

接口结构

万里汇接口报文结构包括:请求头,请求体。关于头信息,详见:

请求参数

字段名

数据类型

是否必传

描述

refundRequestIds

列表<字符串>

是(有条件)

由集成商指定的唯一退款ID。

更多信息:

  • refundRequestIds refundIds 字段不能同时为空
  • 字段最大长度:64字符

refundIds

列表<字符串>

是(有条件)

万里汇受理退款的唯一单号ID。

更多信息:

  • refundRequestIds refundIds 字段不能同时为空
  • 字段最大长度:64字符

响应参数

字段名

数据类型

是否必传

描述

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"
    }
}

@2024 WorldFirst