開發(fā)指引
Native支付可分為兩種模式，商戶根據(jù)支付場景選擇相應模式。
模式一（僅直連模式適用）
開發(fā)前，商戶必須在公眾平臺后臺設置支付回調(diào)URL。URL實現(xiàn)的功能：接收用戶掃碼后微信支付系統(tǒng)回調(diào)的productid和openid；URL設置詳見回調(diào)地址設置。
流程詳細說明：
步驟1 商戶后臺系統(tǒng)根據(jù)微信支付規(guī)定格式【生成二維碼】，展示給用戶掃碼。
步驟2 用戶打開微信“掃一掃”掃描二維碼，微信客戶端將掃碼內(nèi)容發(fā)送到微信支付系統(tǒng)。
步驟3 微信支付系統(tǒng)收到客戶端請求，發(fā)起對商戶后臺系統(tǒng)支付回調(diào)URL的調(diào)用。調(diào)用請求將帶productid和用戶的openid等參數(shù)，并要求商戶系統(tǒng)返回交數(shù)據(jù)包,詳細請見【輸入?yún)?shù)】
步驟4 商戶后臺系統(tǒng)收到微信支付系統(tǒng)的回調(diào)請求，根據(jù)productid生成商戶系統(tǒng)的訂單。
步驟5 商戶系統(tǒng)調(diào)用微信支付【統(tǒng)一下單API】請求下單，獲取交易會話標識（prepay_id）
步驟6 微信支付系統(tǒng)根據(jù)商戶系統(tǒng)的請求生成預支付交易，并返回交易會話標識（prepay_id）。
步驟7 商戶后臺系統(tǒng)得到交易會話標識prepay_id（2小時內(nèi)有效）。
步驟8 商戶后臺系統(tǒng)將prepay_id返回給微信支付系統(tǒng)。返回數(shù)據(jù)見【輸出參數(shù)】
步驟9 微信支付系統(tǒng)根據(jù)交易會話標識，發(fā)起用戶端授權(quán)支付流程。
步驟10 用戶在微信客戶端輸入密碼，確認支付后，微信客戶端提交支付授權(quán)。
步驟11 微信支付系統(tǒng)驗證后扣款，完成支付交易。
步驟12 微信支付系統(tǒng)完成支付交易后給微信客戶端返回交易結(jié)果，并將交易結(jié)果通過短信、微信消息提示用戶。微信客戶端展示支付交易結(jié)果頁面。
步驟13 微信支付系統(tǒng)通過發(fā)送異步消息通知商戶后臺系統(tǒng)支付結(jié)果。商戶后臺系統(tǒng)需回復接收情況，通知微信后臺系統(tǒng)不再發(fā)送該單的支付通知。
步驟14 未收到支付通知的情況，商戶后臺系統(tǒng)調(diào)用【查詢訂單API】。
步驟15 商戶確認訂單已支付后給用戶發(fā)貨。
生成二維碼規(guī)則
二維碼中的內(nèi)容為鏈接，形式為：
weixin：//wxpay/bizpayurl?sign=XXXXX&appid=XXXXX&mch_id=XXXXX&product_id=XXXXXX&time_stamp=XXXXXX&nonce_str=XXXXX
其中XXXXX為商戶需要填寫的內(nèi)容，商戶將該鏈接生成二維碼，如需要打印發(fā)布二維碼，需要采用此格式。商戶可調(diào)用第三方庫生成二維碼圖片。參數(shù)說明如下：
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 應用ID | appid | string[1,32] | 是 | 微信分配的應用ID 示例值：wx8888888888888888 |
| 商戶號 | mch_id | string[1,32] | 是 | 微信支付分配的商戶號 示例值：1900000109 |
| 時間戳 | time_stamp | string[1,10] | 是 | 系統(tǒng)當前時間，定義規(guī)則詳見時間戳 示例值：1414488825 |
| 隨機字符串 | nonce_str | string[1,32] | 是 | 隨機字符串，不長于32位。推薦隨機數(shù)生成算法 示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
| 商品ID | product_id | string[1,32] | 是 | 商戶定義的商品id 或者訂單號 示例值：888888888888 |
| 簽名 | sign | string[1,64] | 是 | 簽名，詳見簽名生成算法 示例值：C380BEC2BFD727A4B6845133519F3AD6 |
weixin：//wxpay/bizpayurl?appid=wx2421b1c4370ec43b&mch_id=10000100&nonce_str=f6808210402125e30663234f94c87a8c&product_id=1&time_stamp=1415949957&sign=512F68131DD251DA4A45DA79CC7EFE9D
回調(diào)商戶支付URL
商戶提供的支付回調(diào)URL（回調(diào)地址設置）需要實現(xiàn)以下功能：接收用戶掃碼后微信支付系統(tǒng)發(fā)送的數(shù)據(jù)，根據(jù)接收的數(shù)據(jù)生成支付訂單，調(diào)用【統(tǒng)一下單API】提交支付交易。
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 應用ID | appid | string[1,32] | 是 | 微信分配的應用ID 示例值：wx8888888888888888 |
| 商戶號 | mch_id | string[1,32] | 是 | 微信支付分配的商戶號 示例值：1900000109 |
| 用戶標識 | openid | string[1,128] | 否 | 用戶在主商戶appid下的唯一標識 示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o |
| 是否關注公眾賬號 | is_subscribe | string[1,1] | 是 | 用戶是否關注公眾賬號，僅在公眾賬號類型支付有效，枚舉值： Y：關注 N：未關注 示例值：Y |
| 隨機字符串 | nonce_str | string[1,32] | 是 | 隨機字符串，不長于32位。推薦隨機數(shù)生成算法 示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
| 商品ID | product_id | string[1,32] | 是 | 商戶定義的商品id 或者訂單號 示例值：888888888888 |
| 簽名 | sign | string[1,64] | 是 | 簽名，詳見簽名生成算法 示例值：C380BEC2BFD727A4B6845133519F3AD6 |
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 返回狀態(tài)碼 | return_code | string[1,16] | 是 | SUCCESS/FAIL 此字段是通信標識，非交易標識，交易是否成功需要查看result_code來判斷 示例值：SUCCESS |
| 返回信息 | return_msg | string[1,128] | 否 | 返回信息，如非空，為錯誤原因 簽名失敗 參數(shù)格式校驗錯誤 示例值：簽名失敗 |
| 應用ID | appid | string[1,32] | 是 | 微信分配的應用ID 示例值：wx8888888888888888 |
| 商戶號 | mch_id | string[1,32] | 是 | 微信支付分配的商戶號 示例值：1900000109 |
| 隨機字符串 | nonce_str | string[1,32] | 是 | 隨機字符串，不長于32位。推薦隨機數(shù)生成算法 示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
| 預支付ID | prepay_id | string[1,64] | 是 | 調(diào)用統(tǒng)一下單接口生成的預支付ID 示例值：wx201410272009395522657a690389285100 |
| 業(yè)務結(jié)果 | result_code | string[1,16] | 是 | SUCCESS/FAIL 示例值：SUCCESS |
| 錯誤描述 | err_code_des | string[1,128] | 否 | 當result_code為FAIL時，商戶展示給用戶的錯誤提 示例值：系統(tǒng)錯誤 |
| 簽名 | sign | string[1,64] | 是 | 簽名，詳見簽名生成算法 示例值：C380BEC2BFD727A4B6845133519F3AD6 |
模式二
商戶后臺系統(tǒng)先調(diào)用微信支付的統(tǒng)一下單接口，微信后臺系統(tǒng)返回鏈接參數(shù)code_url，商戶后臺系統(tǒng)將code_url值生成二維碼圖片，用戶使用微信客戶端掃碼后發(fā)起支付。
注意：code_url有效期為2小時，過期后掃碼不能再發(fā)起支付。
流程詳細說明：
步驟1 商戶后臺系統(tǒng)根據(jù)用戶選購的商品生成訂單。
步驟2 用戶確認支付后調(diào)用微信支付【統(tǒng)一下單API】生成預支付交易；
步驟3 微信支付系統(tǒng)收到請求后生成預支付交易單，并返回交易會話的二維碼鏈接code_url。
步驟4 商戶后臺系統(tǒng)根據(jù)返回的code_url生成二維碼。
步驟5 用戶打開微信“掃一掃”掃描二維碼，微信客戶端將掃碼內(nèi)容發(fā)送到微信支付系統(tǒng)。
步驟6 微信支付系統(tǒng)收到客戶端請求，驗證鏈接有效性后發(fā)起用戶支付，要求用戶授權(quán)。
步驟7 用戶在微信客戶端輸入密碼，確認支付后，微信客戶端提交授權(quán)。
步驟8 微信支付系統(tǒng)根據(jù)用戶授權(quán)完成支付交易。
步驟9 微信支付系統(tǒng)完成支付交易后給微信客戶端返回交易結(jié)果，并將交易結(jié)果通過短信、微信消息提示用戶。微信客戶端展示支付交易結(jié)果頁面。
步驟10 微信支付系統(tǒng)通過發(fā)送異步消息通知商戶后臺系統(tǒng)支付結(jié)果。商戶后臺系統(tǒng)需回復接收情況，通知微信后臺系統(tǒng)不再發(fā)送該單的支付通知。
步驟11 未收到支付通知的情況，商戶后臺系統(tǒng)調(diào)用【查詢訂單API】。
步驟12 商戶確認訂單已支付后給用戶發(fā)貨。
生成二維碼規(guī)則
對應鏈接格式：weixin://wxpay/bizpayurl?sr=123456。請商戶調(diào)用第三方庫將code_url生成二維碼圖片。該模式鏈接較短，生成的二維碼打印到結(jié)賬小票上的識別率較高。
例如，將weixin://wxpay/bizpayurl?sr=123456生成二維碼見下圖
二維碼相關知識
參考文獻：
商品二維碼標準： 國家商品二維碼標準
名片二維碼： 名片二維碼通用技術(shù)規(guī)范
QR碼官方介紹： QR碼官方