線上支付開發文檔
查詢退款

提交退款申請後,通過調用該接口查詢退款狀態。退款有一定延時,請在 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) 商品描述
退款筆數 refund_count Int 退款記錄數
商戶退款單號 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) 商家退款原因
$n 表示記錄的序號,取值為 0~($ refund_count - 1),例如 refund_count 指示返回的退款記錄有 2 條。第一條序號為“0”,第二條序號為“1”。