提交退款申請後,通過調用該接口查詢退款狀態。退款有一定延時,請在 3 個工作日後重新查詢退款狀態。
請求url:https://pay.ionlinepay.com/gateway/
POST Form-Data 內容來進行請求
字段名 | 變量名 | 必填 | 類型 | 說明 |
接口類型 | service | 是 | String(32) | 接口類型:ionline.unified.trade.refundquery |
版本號 | version | 否 | String(8) | 版本號,version默認值是1.0。 |
字符集 | charset | 否 | String(8) | 可選值 UTF-8,默認為 UTF-8。 |
簽名方式 | sign_type | 否 | String(8) | 簽名類型,取值: MD5默認:MD5 |
商戶號 | mch_id | 是 | String(32) | 商戶號,由平台分配 |
商戶訂單號 | out_trade_no | 否 | String(32) | 商戶系統內部的訂單號, out_trade_no和transaction_id至少一個必填,同時存在時transaction_id優先 |
平台訂單號 | transaction_id | 否 | String(32) | 平台訂單號, out_trade_no和transaction_id至少一個必填,同時存在時transaction_id優先 |
商戶退款單號 | out_refund_no | 否 | String(32) | 商戶退款單號, 32個字符內、可包含字母,確保在商戶系統唯一。 |
平台退款單號 | refund_id | 否 | String(32) | 平台退款單號refund_id 、out_refund_no、out_trade_no 、transaction_id 四個參數必填一個, 如果同時存在優先級為: refund_id > out_refund_no > transaction_id > out_trade_no |
隨機字符串 | nonce_str | 是 | String(32) | 隨機字符串,不長於 32 位 |
簽名 | sign | 是 | String(32) | MD5簽名結果,詳見“安全規範” |
數據按JSON的格式實時返回返回結果
字段名 | 變量名 | 必填 | 類型 | 說明 |
版本號 | version | 是 | String(8) | 版本號,version默認值是1.0。 |
字符集 | charset | 是 | String(8) | 可選值 UTF-8,默認為 UTF-8。 |
簽名方式 | sign_type | 是 | String(8) | 簽名類型,取值: MD5默認:MD5 |
返回狀態碼 | status | 是 | String(16) | 0表示成功非0表示失敗此字段是通信標識,非交易標識,交易是否成功需要查看 result_code 來判斷 |
返回信息 | message | 否 | String(128) | 返回信息,如非空,為錯誤原因簽名失敗參數格式校驗錯誤 |
以下字段在 status 為 0的時候有返回 | ||||
業務結果 | result_code | 是 | String(16) | 0表示成功非0表示失敗 |
商戶號 | mch_id | 是 | String(32) | 商戶號,由平台分配 |
設備號 | device_info | 否 | String(32) | 終端設備號 |
隨機字符串 | nonce_str | 是 | String(32) | 隨機字符串,不長於 32 位 |
錯誤代碼 | err_code | 否 | String(32) | 參考錯誤碼 |
簽名 | sign | 是 | String(32) | MD5簽名結果,詳見“安全規範” |
以下字段在 status 和 result_code 都為 0的時候有返回 | ||||
平台訂單號 | transaction_id | 是 | String(32) | 平台交易號 |
商戶訂單號 | out_trade_no | 是 | String(32) | 商戶系統內部的訂單號 |
交易渠道 | trade_channel | 是 | String(32) | WECHATPAY—微信支付 ALIPAY—支付寶 |
交易類型 | trade_type | 是 | String(32) | ionline.pay.weixin.native.intl |
商品描述 | body | 是 | String(127) | 商品描述 |
退款筆數 td> | refund_count | 是 | Int | 退款記錄數 td> |
商戶退款單號 | out_refund_no_$n | 是 | String(32) | 商戶退款單號 |
平台退款單號 | refund_id_$n | 是 | String(32) | 平台退款單號 |
退款渠道 | refund_channel_$n | 是 | String(16) | ORIGINAL—原路退款,默認 |
退款金額 | refund_fee_$n | 是 | Int | 退款總金額,單位為分,可以做部分退款 |
現金券退款金額 | coupon_refund_fee_$n | 否 | Int | 現金券退款金額  ;<= 退款金額, 退款金額-現金券退款金額為現金 |
退款時間 | refund_time_$n | 否 | String(14) | yyyyMMddHHmmss |
退款狀態 | refund_status_$n | 是 | String(16) |
退款狀態: SUCCESS—退款成功 FAIL—退款失敗 PROCESSING—退款處理中 NOTSURE—未確定,需要商戶原退款單號重新發起 CHANGE—轉入代發,退款到銀行發現用戶的卡作廢或者凍結了,導致原路退款銀行卡失敗,資金回流到商戶的現金帳號,需要商戶人工干預,通過線下或者平台轉賬的方式進行退款。 |
退款原因 | refund_reason_$n | 否 | String(127) | 商家退款原因 td> |
$n 表示記錄的序號,取值為 0~($ refund_count - 1),例如 refund_count 指示返回的退款記錄有 2 條。第一條序號為“0”,第二條序號為“1”。 | ||||