查询退款状态

查询退款说明

可以通过该接口实现查询退款状态，每次最多处理 100 笔订单，提交参数必须以 json 格式提交，退款处理后以 json 格式返回，每次退款必须为同一个网关号下订单。

查询退款地址：https://sandbox.mer.fireantspay.com/v3api/isc/queryRefund

查询退款提交

查询退款提交参数列表(json 格式)

参数名	类型	最大长度	是否必填	描述
退款信息
merNo	Long	5	Yes	【商户号】
gatewayNo	Long	8	Yes	【网关接入号】
tradeNoList	List		No	【火蚁流水订单号列表】 不能与‘商户退款流水号列表’同时使用,可以最大查询100笔
refundNoList	List		No	【商户退款流水号列表】 不能与‘火蚁流水订单号列表’同时使用,可以最大查询100笔
signInfo	String	64	Yes	【数字签名信息】 商户号＋网关号＋商户退款流水号列表或商户退款流水号列表所有元素＋密钥，然后进行sha256签名 例如： (merNo+gatewayNo+tradeNoList[0]+...+tradeNoList[n] + signkey);

查询退款请求示例

{
  "gatewayNo": "80000015",
  "merNo": "80000",
  "refundNoList": [],
  "tradeNoList": ["YS024122410125161551416"],
  "signInfo": "4d46d70700448a3a6688b68052078c3ea5c957bf65af056eb88058c68bce06e2"
}

查询退款返回

查询退款返回参数列表(json 格式)

Name	Type	Description
merNo	Long	【商户号】
gatewayNo	Long	【网关接入号】
signInfo	String	【数字签名信息】 sha256(merNo + gatewayNo + each orderNo + signkey)
errorStatus	String	【查询退款状态】 1：查询成功。其他状态为失败。
errorInfo	String	【查询失败原因】
refundOrders	List	【退款订单对象列表】

查询退款返回订单详情表

Name	Type	Description
tradeNo	String	【流水订单号】
orderNo	String	【商户订单号接入号】
refundNo	String	【商户退款流水号】
refundAmount	String	【退款金额】
currency	String	【交易币种】
refundReason	String	【退款原因】
refundStatus	String	【退款状态】 -1:退款失败; 0: 待审核; 1 审核成功未处理 2：审核成功已处理
refundInfo	String	【退款失败原因】

查询退款返回参数示例

{
  "errorStatus": "1",
  "gatewayNo": "80000015",
  "merNo": "80000",
  "refundOrders": [
    {
      "currency": "USD",
      "orderNo": "1224101251615514",
      "refundAmount": "2.21",
      "refundNo": "1224101251615056",
      "refundReason": "缺货客户未回复，部分订单作废",
      "refundStatus": "0",
      "tradeNo": "YS024122410125161551416"
    }
  ],
  "signInfo": "ef0dc3907392eaefe13f2b563dc28efedec0749ab6b106c55352996d5aa0bde6"
}