8 關閉訂單接口
8.1
8.1.1 業務功能
商戶訂單支付失敗需要生成新單號重新發起支付,要對 原訂單號調用關單,避免重複支付;系統下單 後,用戶支付超時,系統退出不再受理,避免用戶繼續,請調用關單接口。
8.1.2 交互模式
請求:後臺請求交互模式
返回結果:後臺請求交互模式
8.1.3 請求參數列表
請求 url:https://gateway.wepayez.com/pay/gateway
POST XML 內容體進行請求
字段名 | 變數名 | 必填 | 類型 | 說明 |
---|---|---|---|---|
接口類型 | service | 是 | String(32) | 接口類型:unified.trade.refund |
版本號 | version | 否 | String(8) | 版本號,version 默認值是 2.0。 |
字元集 | charset | 否 | String(8) | 字元集,取值:UTF-8。 |
簽名方式 | sign_type | 否 | String(8) | 簽名類型,取值:MD5 |
商戶號 | mch_id | 是 | String(32) | 商戶號,由平臺分配 |
商戶訂單號 | out_trade_no | 否 | String(32) | 商戶系統內部的訂單號,32個字元內、可包含字母,確保在商戶系統唯一 |
隨機字串 | nonce_str | 是 | String(32) | 隨機字串,不長於 32 位 |
簽名 | sign | 是 | String(32) | MD5 簽名結果,詳見“第 4 章 MD5 簽名規則” |
8.1.4 返回結果
數據按 XML 的格式即時返回
字段名 | 變數名 | 必填 | 類型 | 說明 |
---|---|---|---|---|
版本號 | version | 是 | String(8) | 版本號,version 默認值是 2.0。 |
字元集 | charset | 是 | String(8) | 字元集,取值:UTF-8。 |
簽名方式 | sign_type | 否 | String(8) | 簽名類型,取值:MD5 |
返回狀態碼 | status | 是 | String(16) | 0 表示成功,非0表示失敗。此字段是通信標識,非交易標識,交易是否成功需要查看 result_code 來判斷 |
返回資訊 | message | 否 | String(128) | 返回資訊,如非空,為錯誤原因簽名失敗參數格式校驗錯誤 |
以下字段在 status 為 0 的時候有返回
字段名 | 變數名 | 必填 | 類型 | 說明 |
---|---|---|---|---|
業務結果 | result_code | 是 | String(16) | 0表示成功,非0表示失敗。0表示關單成功,此筆訂單不能再發起支付;非0或其他表示關單接口異常,需再次發起關單操作 |
商戶號 | mch_id | 是 | String(32) | 商戶號,由平臺分配 |
隨機字串 | nonce_str | 是 | String(32) | 隨機字串,不長於 32 位 |
錯誤代碼 | err_code | 否 | String(32) | 參考錯誤碼 |
錯誤代碼描述 | err_msg | 否 | String(128) | 結果資訊描述 |
簽名 | sign | 是 | String(32) | MD5 簽名結果,詳見“第 4 章 MD5 簽名規則” |