Query Refund Result

Query refund instructions

After submitting a refund request, check the refund status by calling this API. Each request can process a maximum of 100 orders. The submission parameters must be in JSON format, and the refund results will be returned in JSON format after processing. All refunds must be for orders under the same gateway number.

Query refund URL：https://sandbox.mer.fireantspay.com/v3api/isc/queryRefund

Query Refund Submission

Request Parameter (JSON Format)

Name	Type	Max Length	Required	Description
Refund Info
merNo	Long	5	Yes	【Merchant number】
gatewayNo	Long	8	Yes	【Gateway number】
tradeNoList	List		No	【Trade number List】 Cannot be used simultaneously with 'refundNoList'. Maximum of 100 orders can be queried.
refundNoList	List		No	【Merchant refund serial number List】 Cannot be used simultaneously with 'tradeNoList'. Maximum of 100 orders can be queried.
signInfo	String	64	Yes	【Digital signature information】 signInfo=sha256(merNo+ gatewayNo+[ tradeNoList or refundNoList]+ signkey) For example: (merNo+gatewayNo+tradeNoList[0] +...+tradeNoList[n]+ signkey);

Query refund request example

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

Query refund response

Query refund response data (JSON Format)

Name	Type	Description
merNo	Long	【Merchant number】
gatewayNo	Long	【Gateway number】
signInfo	String	【Digital signature information】 sha256(merNo + gatewayNo + each orderNo + signkey)
errorStatus	String	【Query operation result】 1: Success. Other statuses indicate failure.
errorInfo	String	【Failure reason】
refundOrders	List	【Refund order object List】

Refund order object List

Name	Type	Description
tradeNo	String	【Unique identifier allocated by fireantpay】
orderNo	String	【Merchant order number】
refundNo	String	【Merchant refund serial number】
refundAmount	String	【Refund amount】 Number format only
currency	String	【Transaction currency】
refundReason	String	【reason of the refund】
refundStatus	String	Refund status: -1: Refund failed; 0: Pending review; 1: Review successful but not processed; 2: Review successful and processed
refundInfo	String	【Reason for refund failure】

Query refund response example

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