買家授權信用卡支付後,通過調用該接口來獲取訂單金額。強烈建議於買家授權支付後 3-5日內獲取訂單金額,否則將會自動取消授權支付。
請求url:https://pay.ionlinepay.com/gateway/
POST Form-Data 內容來進行請求
字段名 | 變量名 | 必填 | 類型 | 說明 |
接口類型 | service | 是 | String(32) | 接口類型:ionline.unified.trade.capture |
版本號 | 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優先 |
貨幣種類 | fee_type | 是 | String(8) | 貨幣類型,符合 ISO 4217 標準的三位字母代碼 |
訂單總金額 | total_fee | 是 | Int | 總金額,以分為單位,不允許包含任何字、符號 |
獲取總金額 | capture_fee | 是 | Int | 獲取總金額,以分為單位,不允許包含任何字、符號 |
隨機字符串 | 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) | CREDICARD—信用卡 |
交易類型 | trade_type | 是 | String(32) | ionline.pay.firstdata.creditcard |
商品描述 | body | 是 | String(127) | 商品描述 |
貨幣種類 | fee_type | 是 | String(8) | 貨幣類型,符合 ISO 4217 標準的三位字母代碼 |
訂單總金額 | total_fee | 是 | Int | 總金額,以分為單位,不允許包含任何字、符號 |
已獲取金額 | captured_fee | 是 | Int | 已獲取金額,以分為單位,不允許包含任何字、符號 |