線上支付開發文檔
【支付寶】In-App支付

業務功能

初始化請求,通過生成 pay_info 通過 Alipay SDK 來喚起支付寶應用程式來進行 In-App支付。

交互模式

請求:後台請求交互模式

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

請求參數列表

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

POST Form-Data 內容來進行請求

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



接口類型 service String(32) 接口類型: ionline.pay.alipay.inapp.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, 確保平台能通過互聯網訪問該地址
前台地址 return_url String(255) 交易完成後跳轉的URL,需給絕對路徑,255字符內格式如:http://wap.tenpay.com/callback.asp注:該地址只作為前端頁面的一個跳轉,需使用notify_url通知結果作為支付最終結果。
訂單生成時間 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的時候有返回
支付資訊 pay_info String 通過 Alipay SDK 來喚起支付寶應用程式來進行 In-App支付

* Alipay Demo & SDK 可於支付寶官方網站下載: 按此前往

* 使用方法,以 iOS 為例,把 pay_info 傳入至以下參數 "orderString"
[[AlipaySDK defaultService] payOrder:orderString fromScheme:appScheme callback:^(NSDictionary *resultDic) {
NSLog(@"Payment result = %@",resultDic);
}];

如果 resultDic.resultStatus = 9000, 表示支付成功; 其他 resultStatus 則代表不同情況的錯誤,按此查看詳細。