iOnline支付開發文檔
【First Data】信用卡支付

業務功能

初始化請求,通過生成 pay_url 來喚起 First Data 網站進行信用卡支付。

交互模式

請求:後台請求交互模式

返回結果+通知:後台請求交互模式+後台通知交互模式

請求參數列表

請求url:https://pay.ionlinepay.com/gateway/

POST Form-Data 內容來進行請求

字段名 變量名 必填 類型 說明
業務參數



接口類型 service String(32) 接口類型: ionline.pay.firstdata.creditcard
版本號 version String(8) 版本號, version默認值是1.0
字符集 charset String(8) 可選值 UTF-8 ,默認為 UTF-8
簽名方式 sign_type String(8) 簽名類型 ,取值:MD5默認:MD5
商戶號 mch_id String(32) 商戶號,由平台分配
支付授權方式 tx_type String(10) SALE — 自動授權
PREAUTH — 手動授權
* 若使用 PREAUTH (手動授權),則另需調用 Capture API 來獲取訂單金額
信用卡類別 card_type String(10) VISA — Visa 信用卡
MASTERCARD — Mastercard 信用卡
* 不傳則由買客在付款頁面中自行選擇信用卡類別
商戶訂單號 out_trade_no String(32) 商戶系統內部的訂單號 ,32個字符內、 可包含字母,確保在商戶系統唯一
商品描述 body String(127) 商品描述
附加信息 attach String(127) 商戶附加信息,可做擴展參數
貨幣種類 fee_type String(8) 貨幣類型,符合 ISO 4217 標準的三位字母代碼
總金額 total_fee Int 總金額,以分為單位,不允許包含任何字、符號,默認港幣
終端 IP mch_create_ip String(16) 訂單生成的機器 IP
通知地址 notify_url String(255) 接收平台通知的URL,需給絕對路徑,255字符內格式如:http://wap.tenpay.com/tenpay.asp,確保平台能通過互聯網訪問該地址 ; 僅支援 Port 80 或 443
前台地址 return_url String(255) 交易完成後跳轉的URL,需給絕對路徑,255字符內格式如:http://wap.tenpay.com/callback.asp注:該地址只作為前端頁面的一個跳轉,需使用notify_url通知結果作為支付最終結果。
操作員 op_user_id String(32) 操作員帳號 ,默認為商戶號
商品標記 goods_tag String(32) 商品標記,微信平台配置的商品標記,用於優惠券或者滿減使用
商品  ID product_id String(32) 預留字段此 id 為靜態可打印的二維碼中包含的商品 ID,商戶自行維護。
隨機字符串 nonce_str String(32) 隨機字符串,不長於 32 位
是否限制信用卡 limit_credit_pay String (32) 限定用戶使用時能否使用信用卡,值為1,禁用信用卡;值為0或者不傳此參數則不禁用
簽名 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) 商戶號,由平台分配
隨機字符串 nonce_str String(32) 隨機字符串,不長於 32 位
錯誤代碼 err_code String(32) 參考錯誤碼
錯誤代碼描述 err_msg String(128) 結果信息描述
簽名 sign String(32) MD5簽名結果,詳見“安全規範”
以下字段在 status 和 result_code 都為 0 的時候有返回
支付地址 pay_url String(128) 喚起 First Data 網站進行信用卡支付URL地址