初始化掃碼請求,通過該請求生成二維碼來進行掃碼支付。
請求:後台請求交互模式
返回結果+通知:後台請求交互模式+後台通知交互模式
請求url:https://pay.ionlinepay.com/gateway/
POST Form-Data 內容來進行請求
字段名 | 變量名 | 必填 | 類型 | 說明 |
業務參數 |
|
|
|
|
接口類型 | service | 是 | String(32) | 接口類型: ionline.pay.weixin.native.intl |
版本號 | 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) | 商戶系統內部的訂單號 ,32個字符內、 可包含字母,確保在商戶系統唯一 |
設備號 | device_info | 否 | String(32) | 終端設備號 |
商品描述 | body | 是 | String(127) | 商品描述 |
附加信息 | attach | 否 | String(127) | 商戶附加信息,可做擴展參數 |
總金額 | total_fee | 是 | Int | 總金額,以分為單位,不允許包含任何字、符號,默認港幣 |
終端 IP | mch_create_ip | 是 | String(16) | 訂單生成的機器 IP |
通知地址 | notify_url | 是 | String(255) | 接收平台通知的URL,需給絕對路徑,255字符內格式如:http://wap.tenpay.com/tenpay.asp, 確保平台能通過互聯網訪問該地址 |
訂單生成時間 | time_start | 否 | String(14) | 訂單生成時間,格式為yyyyMMddHHmmss,如2017年5月20日9點41分30秒會表示為20170520094130。時區為GMT+8 Hong Kong。該時間取自商戶服務器 |
訂單超時時間 | time_expire | 否 | String(14) | 訂單失效時間,格式為yyyyMMddHHmmss,如2017年5月20日21點41分30秒會表示為20170520214130。時區為GMT+8 Hong Kong。該時間取自商戶服務器 * 需同時 time_start 參數才會生效。 |
操作員 | 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) | 商戶號,由平台分配 |
設備號 | device_info | 否 | String(32) | 終端設備號 |
隨機字符串 | nonce_str | 是 | String(32) | 隨機字符串,不長於 32 位 |
錯誤代碼 | err_code | 否 | String(32) | 參考錯誤碼 |
錯誤代碼描述 | err_msg | 否 | String(128) | 結果信息描述 |
簽名 | sign | 是 | String(32) | MD5簽名結果,詳見“安全規範” |
以下字段在 status 和 result_code 都為 0的時候有返回 | ||||
二維碼鏈接 td> | code_url | 是 | String(64) | 商戶可用此參數自定義去生成二維碼後展示出來進行掃碼支付 |
二維碼圖片 td> | code_img_url | 是 | String(256) | 此參數的值即是根據code_url生成的可以掃碼支付的二維碼圖片地址 |