# 1. 接口規(guī)則

為了在保證支付安全的前提下，帶給商戶簡(jiǎn)單、一致且易用的開(kāi)發(fā)體驗(yàn)，我們推出了全新的微信支付APIv3接口。該版本API的具體規(guī)則請(qǐng)參考APIv3接口規(guī)則。

# 2. 開(kāi)發(fā)準(zhǔn)備

# 2.1. 搭建和配置開(kāi)發(fā)環(huán)境

為了幫助開(kāi)發(fā)者調(diào)用開(kāi)放接口，我們提供了JAVA、PHP、GO三種語(yǔ)言版本的開(kāi)發(fā)庫(kù)，封裝了簽名生成、簽名驗(yàn)證、敏感信息加/解密、媒體文件上傳 等基礎(chǔ)功能（更多語(yǔ)言版本的開(kāi)發(fā)庫(kù)將在近期陸續(xù)提供）。

測(cè)試步驟：

1、根據(jù)自身開(kāi)發(fā)語(yǔ)言，選擇對(duì)應(yīng)的開(kāi)發(fā)庫(kù)并構(gòu)建項(xiàng)目，具體配置請(qǐng)參考下面鏈接的詳細(xì)說(shuō)明：

• wechatpay-java (opens new window)（推薦）、wechatpay-apache-httpclient (opens new window)，適用于Java開(kāi)發(fā)者。
  • 注：當(dāng)前開(kāi)發(fā)指引接口JAVA示例代碼采用wechatpay-apache-httpclient版本。
• wechatpay-php (opens new window)（推薦）、wechatpay-guzzle-middleware (opens new window)，適用于PHP開(kāi)發(fā)者。
  • 注：當(dāng)前開(kāi)發(fā)指引接口PHP示例代碼采用wechatpay-guzzle-middleware版本。
• wechatpay-go (opens new window)，適用于Go開(kāi)發(fā)者。

更多資源可前往微信支付開(kāi)發(fā)者社區(qū) (opens new window)搜索查看。

2、創(chuàng)建加載商戶私鑰、加載平臺(tái)證書、初始化httpClient的通用方法。

3、基于接口的示例代碼，替換請(qǐng)求參數(shù)后可發(fā)起測(cè)試。

說(shuō)明：

• 上面的開(kāi)發(fā)庫(kù)為微信支付官方開(kāi)發(fā)庫(kù)，其它沒(méi)有審核或者控制下的第三方工具和庫(kù)，微信支付不保證它們的安全性和可靠性。通過(guò)包管理工具引入SDK后，可根據(jù)下面每個(gè)接口的示例代碼替換相關(guān)參數(shù)后進(jìn)行快速測(cè)試。
• 開(kāi)發(fā)者如果想詳細(xì)了解簽名生成、簽名驗(yàn)證、敏感信息加/解密、媒體文件上傳等常用方法的具體代碼實(shí)現(xiàn)，可閱讀下面的詳細(xì)說(shuō)明：

1. 簽名生成
2. 簽名驗(yàn)證
3. 敏感信息加解密
4. merchantPrivateKey（私鑰）
5. wechatpayCertificates（平臺(tái)證書）
6. APIV3Key（V3 key）

• 如想更詳細(xì)的了解我們的接口規(guī)則，可查看我們的接口規(guī)則指引文檔。

# 2.2. 業(yè)務(wù)開(kāi)發(fā)配置

合單支付目前支持在微信外H5、App、JSAPI、小程序、Native掃碼5個(gè)場(chǎng)景使用，下面依次為你介紹這5個(gè)場(chǎng)景需求進(jìn)行的業(yè)務(wù)開(kāi)發(fā)配置

# 2.2.1. 微信外H5場(chǎng)景開(kāi)發(fā)配置

開(kāi)通H5支付權(quán)限：前往【微信支付商戶平臺(tái) (opens new window)—>產(chǎn)品中心—>H5支付—>申請(qǐng)開(kāi)通】。

設(shè)置H5支付域名：登錄【微信支付商戶平臺(tái) (opens new window)—>產(chǎn)品中心—>開(kāi)發(fā)配置—>H5支付】，設(shè)置后一般10分鐘內(nèi)生效。

# 2.2.2. App場(chǎng)景開(kāi)發(fā)配置

# 一、注冊(cè)App

App接入微信支付，需要先將商戶App在微信開(kāi)放平臺(tái)進(jìn)行注冊(cè)，登記App開(kāi)發(fā)參數(shù)以生成AppID。具體操作步驟如下：

1. 登錄微信開(kāi)放平臺(tái)，進(jìn)入【管理中心 → 移動(dòng)應(yīng)用 → 創(chuàng)建移動(dòng)應(yīng)用】；

   

2. 完成基本信息的錄入，商戶需要在本步驟提交App對(duì)應(yīng)的下載地址，應(yīng)用官網(wǎng)，應(yīng)用水印，icon等業(yè)務(wù)信息；

   

3. 完成平臺(tái)信息的錄入，商戶需要在本步驟提交App在Android及iOS端對(duì)應(yīng)的開(kāi)發(fā)參數(shù)，包括Android端應(yīng)用的包名，應(yīng)用簽名，iOS端應(yīng)用的bundle ID, universal link等；

   

   注意

   Android應(yīng)用包名和簽名的相關(guān)說(shuō)明，請(qǐng)參考Android開(kāi)發(fā)要點(diǎn)說(shuō)明 (opens new window)。

4. 以上信息全部提交完成后，即完成App的注冊(cè)，商戶可在【管理中心 → 移動(dòng)應(yīng)用】中，選擇具體的應(yīng)用查看其AppID及已獲得的接口能力；

   

5. 獲取到App的AppID后，需要將該AppID與商戶的收款mch_id進(jìn)行綁定，商戶可登錄商戶平臺(tái)后前往【產(chǎn)品中心 -> AppID賬號(hào)管理】界面中進(jìn)行AppID的綁定及管理，界面如圖所示。

   

# 二、iOS開(kāi)發(fā)要點(diǎn)說(shuō)明

• iOS系統(tǒng)OpenSDK升級(jí)指引：

由于蘋果公司在iOS13系統(tǒng)回收了查詢 App bundleID 的能力，導(dǎo)致微信無(wú)法保證授權(quán)憑證能正確返回給AppID對(duì)應(yīng)的應(yīng)用。為此，微信支付強(qiáng)烈要求所有商戶盡快升級(jí)到OpenSDK1.8.6，并讓用戶及時(shí)更新App，否則安全風(fēng)險(xiǎn)將一直存在。謝謝配合！

詳細(xì)OpenSDK升級(jí)指引請(qǐng)參見(jiàn)：OpenSDK升級(jí)指引 (opens new window)

• 開(kāi)發(fā)配置：

以下項(xiàng)目開(kāi)發(fā)環(huán)境以Xcode6.0，運(yùn)行環(huán)境為IOS7.0為例，說(shuō)明其開(kāi)發(fā)中需要的操作。

# 1. 項(xiàng)目設(shè)置AppID

商戶在微信開(kāi)放平臺(tái)申請(qǐng)開(kāi)發(fā)App應(yīng)用后，微信開(kāi)放平臺(tái)會(huì)生成App的唯一標(biāo)識(shí)AppID。在Xcode中打開(kāi)項(xiàng)目，設(shè)置項(xiàng)目屬性中的URL Schemes為您的AppID。如圖標(biāo)紅位置所示。

# 2. 注冊(cè)AppID

商戶App工程中引入微信lib庫(kù)和頭文件，調(diào)用API前，需要先向微信注冊(cè)您的AppID，代碼如下：

[WXApi registerApp：@"wxd930ea5d5a258f4f" withDescription：@"demo 2.0"];

# 三、Android開(kāi)發(fā)要點(diǎn)說(shuō)明

# 1.后臺(tái)設(shè)置

商戶在微信開(kāi)放平臺(tái)申請(qǐng)開(kāi)發(fā)應(yīng)用后，微信開(kāi)放平臺(tái)會(huì)生成App的唯一標(biāo)識(shí)AppID。由于需要保證支付安全，需要在開(kāi)放平臺(tái)綁定商戶應(yīng)用包名和應(yīng)用簽名，設(shè)置好后才能正常發(fā)起支付。設(shè)置界面在【開(kāi)放平臺(tái)】中的欄目【管理中心-> 修改應(yīng)用 -> 修改開(kāi)發(fā)信息】里面，如圖紅框內(nèi)所示。

應(yīng)用包名：是在App項(xiàng)目配置文件AndroidManifest.xml中聲明的package值，例如圖中的package="demo.wxpay.tenpay.com"。

應(yīng)用簽名：根據(jù)項(xiàng)目的應(yīng)用包名和編譯使用的keystore，可由簽名工具生成一個(gè)32位的md5串，在調(diào)試的手機(jī)上安裝簽名工具后，運(yùn)行可生成應(yīng)用簽名串，如圖所示，綠色串即應(yīng)用簽名。簽名工具下載 (opens new window)

# 2.注冊(cè)AppID

商戶App工程中引入微信JAR包，調(diào)用API前，需要先向微信注冊(cè)您的AppID，代碼如下：

final IWXAPI msgApi = WXAPIFactory.createWXAPI(context, null);

// 將該App注冊(cè)到微信

msgApi.registerApp("wxd930ea5d5a258f4f");

# 2.2.3. JSAPI場(chǎng)景開(kāi)發(fā)配置

# 設(shè)置支付目錄

• 支付授權(quán)目錄說(shuō)明：

  1. 商戶最后請(qǐng)求拉起微信支付收銀臺(tái)的頁(yè)面地址我們稱之為“支付目錄”，例如：https://www.weixin.com/pay.php。
  2. 商戶實(shí)際的支付目錄必須和在微信支付商戶平臺(tái) (opens new window)設(shè)置的一致，否則會(huì)報(bào)錯(cuò)“當(dāng)前頁(yè)面的URL未注冊(cè)”。

• 支付授權(quán)目錄設(shè)置說(shuō)明：

  • 登錄【微信支付服務(wù)商平臺(tái) (opens new window)->產(chǎn)品中心->開(kāi)發(fā)配置】，設(shè)置后一般5分鐘內(nèi)生效。（配置頁(yè)見(jiàn)圖）

• 支付授權(quán)目錄校驗(yàn)規(guī)則說(shuō)明：

  1. 如果支付授權(quán)目錄設(shè)置為頂級(jí)域名（例如：https://www.weixin.com/ ），那么只校驗(yàn)頂級(jí)域名，不校驗(yàn)后綴；
  2. 如果支付授權(quán)目錄設(shè)置為多級(jí)目錄，就會(huì)進(jìn)行全匹配，例如設(shè)置支付授權(quán)目錄為 https://www.weixin.com/abc/123/，則實(shí)際請(qǐng)求頁(yè)面目錄不能為 https://www.weixin.com/abc/，也不能為 https://www.weixin.com/abc/123/pay/，必須為 https://www.weixin.com/abc/123/

# 設(shè)置授權(quán)域名

授權(quán)域名說(shuō)明： 開(kāi)發(fā)JSAPI支付時(shí)，在JSAPI下單接口中要求必傳用戶OpenID，而獲取OpenID則需要您在公眾平臺(tái)設(shè)置獲取OpenID的域名，只有被設(shè)置過(guò)的域名才是一個(gè)有效的獲取OpenID的域名，否則將獲取失敗。具體配置頁(yè)如圖2所示

授權(quán)域名設(shè)置說(shuō)明： 登錄【微信公眾平臺(tái) (opens new window)->公眾號(hào)設(shè)置】

# 2.2.4. 小程序場(chǎng)景開(kāi)發(fā)配置

賬號(hào)申請(qǐng)指引：

1. 小程序開(kāi)通微信支付，即申請(qǐng)或復(fù)用微信支付商戶號(hào) 申請(qǐng)完小程序后，登錄小程序后臺(tái) (opens new window)。點(diǎn)擊左側(cè)導(dǎo)航欄的微信支付，在頁(yè)面中進(jìn)行開(kāi)通。（開(kāi)通申請(qǐng)要求小程序已發(fā)布上線）

   

2. 點(diǎn)擊開(kāi)通按鈕后，有2種方式可以獲取微信支付能力，新申請(qǐng)微信支付商戶號(hào)或綁定一個(gè)已有的微信支付商戶號(hào)，請(qǐng)根據(jù)你的業(yè)務(wù)需要和具體情況選擇，只能二選一。詳見(jiàn)微信支付商戶接入指引 (opens new window)

   

服務(wù)器配置要求：

1. 小程序訪問(wèn)商戶服務(wù)都是通過(guò)HTTPS,開(kāi)發(fā)部署的時(shí)候需要HTTPS服務(wù)器。
2. 服務(wù)器域名配置。
   • 每個(gè)微信小程序需要事先設(shè)置通訊域名，小程序只可以跟指定的域名進(jìn)行網(wǎng)絡(luò)通信。包括普通 HTTPS 請(qǐng)求（wx.request）、上傳文件（wx.uploadFile）、下載文件（wx.downloadFile）和 WebSocket 通信（wx.connectSocket）。
   • 從基礎(chǔ)庫(kù) 2.4.0 開(kāi)始，網(wǎng)絡(luò)接口允許與局域網(wǎng) IP 通信，但要注意 不允許與本機(jī) IP 通信。

# 2.2.5. Native掃碼場(chǎng)景開(kāi)發(fā)配置

暫無(wú)需特殊配置內(nèi)容。

# 3. 快速接入

# 3.1. 業(yè)務(wù)流程圖

重要步驟說(shuō)明：

步驟1 用戶在商戶側(cè)發(fā)起支付請(qǐng)求，商戶先通過(guò)后臺(tái)接口合單下單接口創(chuàng)建合單支付訂單。

步驟2 商戶再根據(jù)用戶發(fā)起支付請(qǐng)求的具體場(chǎng)景通過(guò)H5 (opens new window)/小程序 (opens new window)/App (opens new window)/公眾號(hào) (opens new window)頁(yè)面調(diào)起微信支付收銀臺(tái)，完成支付請(qǐng)求。

步驟3 用戶支付成功后，商戶可接收到支付結(jié)果回調(diào)通知 (opens new window)。

步驟4 如果商戶長(zhǎng)時(shí)間未收到回調(diào)通知，可通過(guò)合單查詢訂單 (opens new window)接口主動(dòng)查詢訂單支付狀態(tài)。

# 3.2. API接入（含示例代碼）

本文檔展示了如何使用微信支付服務(wù)端 SDK 快速接入合單支付產(chǎn)品，完成與微信支付對(duì)接的部分。

# 3.2.1.【服務(wù)端】合單下單

步驟說(shuō)明： 用戶在商戶側(cè)選擇商品下單購(gòu)買時(shí)，商戶系統(tǒng)先調(diào)用該接口在微信支付服務(wù)后臺(tái)生成預(yù)支付交易單，然后使用我們提供的客戶端方法（下文介紹）調(diào)起微信支付收銀臺(tái)，即可完成支付。

合單下單接口為了區(qū)分用戶發(fā)起支付的5個(gè)場(chǎng)景：微信外H5、App、JSAPI、小程序、Native掃碼，我們分別使用了4個(gè)不同接口地址對(duì)應(yīng)這5個(gè)場(chǎng)景（小程序與公眾號(hào)合單下單接口地址相同）：

https://api.mch.weixin.qq.com/v3/combine-transactions/h5 ——微信外H5場(chǎng)景合單下單接口地址。

https://api.mch.weixin.qq.com/v3/combine-transactions/app ——App場(chǎng)景合單下單接口地址。

https://api.mch.weixin.qq.com/v3/combine-transactions/jsapi ——JSAPI、小程序場(chǎng)景合單下單接口地址。

https://api.mch.weixin.qq.com/v3/combine-transactions/native ——Native掃碼場(chǎng)景合單下單接口地址。

下面以JSAPI、小程序場(chǎng)景為例，為你展示基礎(chǔ)下單接口的請(qǐng)求示例。

1try {
2    $resp = $client->request(
3        'POST',
4        'https://api.mch.weixin.qq.com/v3/combine-transactions/jsapi', //請(qǐng)求URL
5        [
6            // JSON請(qǐng)求體
7            'json' => [
8                "combine_out_trade_no" => "1217752501201407033233368018",
9                "combine_mchid" => "1230000109",
10                "combine_appid" => "wxd678efh567hg6787",
11                "scene_info" => [
12                    "device_id" => "POS1:1",
13                    "payer_client_ip" => "14.17.22.32",
14                ],
15                "sub_orders" => [
16                    [
17                        "mchid" => "1230000109",
18                        "attach" => "深圳分店",
19                        "amount" => [
20                            "total_amount" => 10,
21                            "currency" => "CNY",
22                        ],
23                        "out_trade_no" => "20150806125346",
24                        "sub_mchid" => "1900000109",
25                        "description" => "騰訊充值中心-QQ會(huì)員充值",
26                    ],
27                ],
28                "combine_payer_info" => [
29                    "openid" => "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
30                ],
31                "time_start" => "2018-06-08T10:34:56+08:00",
32                "time_expire" => "2018-06-08T10:34:56+08:00",
33                "notify_url" => "https://yourapp.com/notify",
34            ],
35            'headers' => [ 'Accept' => 'application/json' ]
36        ]
37    );
38    $statusCode = $resp->getStatusCode();
39    if ($statusCode == 200) { //處理成功
40        echo "success,return body = " . $resp->getBody()->getContents()."\n";
41    } else if ($statusCode == 204) { //處理成功，無(wú)返回Body
42        echo "success";
43    }
44} catch (RequestException $e) {
45    // 進(jìn)行錯(cuò)誤處理
46    echo $e->getMessage()."\n";
47    if ($e->hasResponse()) {
48        echo "failed,resp code = " . $e->getResponse()->getStatusCode() . " return body = " . $e->getResponse()->getBody() . "\n";
49    }
50    return;
51}

重要入?yún)⒄f(shuō)明：

• out_trade_no： 商戶系統(tǒng)內(nèi)部訂單號(hào)，只能是數(shù)字、大小寫字母_-*且在同一個(gè)商戶號(hào)下唯一。
• description： 商品描述。
• notify_url： 支付回調(diào)通知URL，該地址必須為直接可訪問(wèn)的URL，不允許攜帶查詢串。
• total： 訂單總金額，單位為分。
• OpenID： OpenID是微信用戶在AppID下的唯一用戶標(biāo)識(shí)（AppID不同，則獲取到的OpenID就不同），可用于永久標(biāo)記一個(gè)用戶。OpenID獲取方式請(qǐng)參考以下文檔小程序獲取OpenID (opens new window)、公眾號(hào)獲取OpenID (opens new window)、App獲取OpenID (opens new window)。

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請(qǐng)參見(jiàn) 合單JSAPI下單 (opens new window)。

# 3.2.2.【客戶端】JSAPI調(diào)起支付

步驟說(shuō)明： 通過(guò)合單下單API成功獲取預(yù)支付交易會(huì)話標(biāo)識(shí)（prepay_id）后，需要通過(guò)JSAPI調(diào)起支付API來(lái)調(diào)起微信支付收銀臺(tái)。

示例代碼：

1function onBridgeReady() {
2    WeixinJSBridge.invoke('getBrandWCPayRequest', {
3        "appId": "wx2421b1c4370ecxxx",    //公眾號(hào)ID，由商戶傳入
4        "timeStamp": "1395712654",     //時(shí)間戳，自1970年以來(lái)的秒數(shù)
5        "nonceStr": "e61463f8efa94090b1f366cccfbbb444",  //隨機(jī)串
6        "package": "prepay_id=up_wx21201855730335ac86f8c43d1889123400",
7        "signType": "RSA",    //微信簽名方式：
8        "paySign": "oR9d8PuhnIc+YZ8cBHFCwfgpaK9gd7vaRvkYD7rthRAZ\/X+QBhcCYL21N7cHCTUxbQ+EAt6Uy+lwSN22f5YZvI45MLko8Pfso0jm46v5hqcVwrk6uddkGuT+Cdvu4WBqDzaDjnNa5UK3GfE1Wfl2gHxIIY5lLdUgWFts17D4WuolLLkiFZV+JSHMvH7eaLdT9N5GBovBwu5yYKUR7skR8Fu+LozcSqQixnlEZUfyE55feLOQTUYzLmR9pNtPbPsu6WVhbNHMS3Ss2+AehHvz+n64GDmXxbX++IOBvm2olHu3PsOUGRwhudhVf7UcGcunXt8cqNjKNqZLhLw4jq\/xDg==" //微信簽名
9    },
10    function(res) {
11        if (res.err_msg == "get_brand_wcpay_request:ok") {
12            // 使用以上方式判斷前端返回,微信團(tuán)隊(duì)鄭重提示：
13            //res.err_msg將在用戶支付成功后返回ok，但并不保證它絕對(duì)可靠。
14        }
15    });
16}
17if (typeof WeixinJSBridge == "undefined") {
18    if (document.addEventListener) {
19        document.addEventListener('WeixinJSBridgeReady', onBridgeReady, false);
20    } else if (document.attachEvent) {
21        document.attachEvent('WeixinJSBridgeReady', onBridgeReady);
22        document.attachEvent('onWeixinJSBridgeReady', onBridgeReady);
23    }
24} else {
25    onBridgeReady();
26}

重要入?yún)⒄f(shuō)明：

• package： JSAPI下單接口返回的prepay_id參數(shù)值，提交格式如：prepay_id=***。
• signType： 該接口V3版本僅支持RSA。
• paySign： 簽名。

paySign生成規(guī)則、響應(yīng)詳情及錯(cuò)誤碼請(qǐng)參見(jiàn) JSAPI調(diào)起支付 (opens new window)接口文檔。

# 3.2.3.【客戶端】App調(diào)起支付

步驟說(shuō)明： 通過(guò)App下單API成功獲取**預(yù)支付交易會(huì)話標(biāo)識(shí)（prepay_id）**后，需要通過(guò)OpenSDK來(lái)調(diào)起微信支付收銀臺(tái)

重要入?yún)⒄f(shuō)明：

• package： 取固定值Sign=WXPay。
• signType： 該接口V3版本僅支持RSA。
• paySign： 簽名。

paySign生成規(guī)則、響應(yīng)詳情及錯(cuò)誤碼請(qǐng)參見(jiàn)App調(diào)起支付 (opens new window)接口文檔。

# iOS SDK調(diào)用說(shuō)明

一、拉起支付

商戶服務(wù)器生成支付訂單，先調(diào)用App下單API生成預(yù)付單，獲取到prepay_id后將參數(shù)再次簽名傳輸給App發(fā)起支付。以下是調(diào)起微信支付的關(guān)鍵代碼：

1PayReq *request = [[[PayReq alloc] init] autorelease];
2request.partnerId = @"10000100";
3request.prepayId= @"1101000000140415649af9fc314aa427";
4request.package = @"Sign=WXPay";
5request.nonceStr= @"a462b76e7436e98e0ed6e13c64b4fd1c";
6request.timeStamp= @"1397527777";
7request.sign= @"582282D72DD2B03AD892830965F428CB16E7A256";
8[WXApi sendReq：request]

該sign生成字段名列表見(jiàn)調(diào)起支付API (opens new window)

二、SDK結(jié)果回調(diào)

照微信SDK Sample，在類實(shí)現(xiàn)onResp函數(shù)，支付完成后，微信App會(huì)返回到商戶App并回調(diào)onResp函數(shù)，開(kāi)發(fā)者需要在該函數(shù)中接收通知，判斷返回錯(cuò)誤碼，如果支付成功則去后臺(tái)查詢支付結(jié)果再展示用戶實(shí)際支付結(jié)果。注意 一定不能以客戶端返回作為用戶支付的結(jié)果，應(yīng)以服務(wù)器端的接收的支付通知或查詢API返回的結(jié)果為準(zhǔn)。代碼示例如下：

1-(void)onResp：(BaseResp*)resp{
2  if ([respisKindOfClass：[PayRespclass]]){
3      PayResp*response=(PayResp*)resp;
4      switch(response.errCode){
5                  caseWXSuccess： //服務(wù)器端查詢支付通知或查詢API返回的結(jié)果再提示成功
6                           NSlog(@"支付成功");
7                  break;
8                  default：
9                           NSlog(@"支付失敗，retcode=%d",resp.errCode);
10                  break;
11        }
12   }
13}

回調(diào)中errCode值列表：

Android SDK調(diào)用說(shuō)明：

# 一、SDK拉起支付

商戶服務(wù)器生成支付訂單，先調(diào)用【App下單API】生成預(yù)付單，獲取到prepay_id后將參數(shù)再次簽名傳輸給App發(fā)起支付。以下是調(diào)起微信支付的關(guān)鍵代碼：

1IWXAPI api;
2PayReq request = new PayReq();
3request.appId = "wxd930ea5d5a258f4f";
4request.partnerId = "1900000109";
5request.prepayId= "1101000000140415649af9fc314aa427",;
6request.packageValue = "Sign=WXPay";
7request.nonceStr= "1101000000140429eb40476f8896f4c9";
8request.timeStamp= "1398746574";
9request.sign= "7FFECB600D7157C5AA49810D2D8F28BC2811827B";
10api.sendReq(request);

該sign生成字段名列表見(jiàn)調(diào)起支付API (opens new window)

# 二、支付結(jié)果回調(diào)

參照微信SDK Sample，在商戶包名.wxapi包路徑中實(shí)現(xiàn)WXPayEntryActivity類(包名或類名不一致會(huì)造成無(wú)法回調(diào))，在WXPayEntryActivity類中實(shí)現(xiàn)onResp函數(shù)，支付完成后，微信App會(huì)返回到商戶App并回調(diào)onResp函數(shù)，開(kāi)發(fā)者需要在該函數(shù)中接收通知，判斷返回錯(cuò)誤碼，如果支付成功則去后臺(tái)查詢支付結(jié)果再展示用戶實(shí)際支付結(jié)果。注意一定不能以客戶端返回作為用戶支付的結(jié)果，應(yīng)以服務(wù)器端的接收的支付通知或查詢API返回的結(jié)果為準(zhǔn)。代碼示例如下：

1publicvoidonResp(BaseRespresp){
2    if(resp.getType()==ConstantsAPI.COMMAND_PAY_BY_WX){
3    Log.d(TAG,"onPayFinish,errCode="+resp.errCode);
4    AlertDialog.Builderbuilder=newAlertDialog.Builder(this);
5    builder.setTitle(R.string.app_tip);
6    }
7}

回調(diào)中errCode值列表：

# 3.2.4. 【客戶端】小程序調(diào)起支付API

步驟說(shuō)明： 通過(guò)小程序下單API成功獲取預(yù)支付交易會(huì)話標(biāo)識(shí)（prepay_id）后，需要通過(guò)小程序調(diào)起支付API來(lái)調(diào)起微信支付收銀臺(tái)。

示例代碼：

1wx.requestPayment(
2{
3"timeStamp": "1414561699",
4"nonceStr": "5K8264ILTKCH16CQ2502SI8ZNMTM67VS",
5"package": "prepay_id=wx201410272009395522657a690389285100",
6"signType": "RSA",
7"paySign": "oR9d8PuhnIc+YZ8cBHFCwfgpaK9gd7vaRvkYD7rthRAZ\/X+QBhcCYL21N7cHCTUxbQ+EAt6Uy+lwSN22f5YZvI45MLko8Pfso0jm46v5hqcVwrk6uddkGuT+Cdvu4WBqDzaDjnNa5UK3GfE1Wfl2gHxIIY5lLdUgWFts17D4WuolLLkiFZV+JSHMvH7eaLdT9N5GBovBwu5yYKUR7skR8Fu+LozcSqQixnlEZUfyE55feLOQTUYzLmR9pNtPbPsu6WVhbNHMS3Ss2+AehHvz+n64GDmXxbX++IOBvm2olHu3PsOUGRwhudhVf7UcGcunXt8cqNjKNqZLhLw4jq\/xDg==",
8"success":function(res){},
9"fail":function(res){},
10"complete":function(res){}
11})

重要入?yún)⒄f(shuō)明：

• package：小程序下單接口返回的prepay_id參數(shù)值，提交格式如：prepay_id=***。
• signType：該接口V3版本僅支持RSA。
• paySign：簽名。

paySign生成規(guī)則、響應(yīng)詳情及錯(cuò)誤碼請(qǐng)參見(jiàn)小程序調(diào)起支付API (opens new window)接口文檔。

# 3.2.5. 【客戶端】生成支付二維碼

步驟說(shuō)明： 通過(guò)Native下單API成功獲取支付二維碼鏈接（code_url）后，需要在前端（PC網(wǎng)頁(yè)或POS機(jī)具）生成二維碼供用戶掃描支付。

# 3.2.6. 【客戶端】微信外H5瀏覽器拉起微信支付中間頁(yè)

步驟說(shuō)明： 通過(guò)H5下單API成功獲取H5下單返回的支付中間頁(yè)（h5_url）后，用戶需要通過(guò)微信外部的瀏覽器調(diào)起微信支付收銀臺(tái)

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請(qǐng)參見(jiàn)H5調(diào)起支付API (opens new window)接口文檔

# 3.2.7.【服務(wù)端】接收支付結(jié)果通知

步驟說(shuō)明： 當(dāng)用戶完成支付，微信會(huì)把相關(guān)支付結(jié)果將通過(guò)異步回調(diào)的方式通知商戶，商戶需要接收處理，并按文檔規(guī)范返回應(yīng)答。

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請(qǐng)參見(jiàn)支付通知API (opens new window)接口文檔。

# 3.2.8. 【服務(wù)端】合單查詢訂單

步驟說(shuō)明： 當(dāng)商戶后臺(tái)、網(wǎng)絡(luò)、服務(wù)器等出現(xiàn)異常，商戶系統(tǒng)最終未接收到支付通知時(shí)商戶可通過(guò)查詢訂單接口核實(shí)訂單支付狀態(tài)。

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請(qǐng)參見(jiàn) 查詢訂單API (opens new window)接口文檔。

# 3.2.9. 【服務(wù)端】合單關(guān)閉訂單

步驟說(shuō)明： 當(dāng)商戶訂單支付失敗需要生成新單號(hào)重新發(fā)起支付，要對(duì)原訂單號(hào)調(diào)用關(guān)單，避免重復(fù)支付；系統(tǒng)下單后，用戶支付超時(shí)，系統(tǒng)退出不再受理，避免用戶繼續(xù)，請(qǐng)調(diào)用關(guān)單接口。

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請(qǐng)參見(jiàn) 合單關(guān)單API (opens new window)接口文檔。

# 3.2.10. 【服務(wù)端】申請(qǐng)交易賬單

步驟說(shuō)明： 微信支付按天提供交易賬單文件，商戶可以通過(guò)該接口獲取賬單文件的下載地址

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請(qǐng)參見(jiàn)申請(qǐng)交易賬單API (opens new window) 接口文檔。

# 3.2.11. 【服務(wù)端】下載賬單

步驟說(shuō)明： 通過(guò)申請(qǐng)交易賬單接口獲取到賬單下載地址（download_url）后，再通過(guò)該接口獲取到對(duì)應(yīng)的賬單文件，文件內(nèi)包含交易相關(guān)的金額、時(shí)間、營(yíng)銷等信息，供商戶核對(duì)訂單、退款、銀行到賬等情況。

更多參數(shù)、響應(yīng)詳情及錯(cuò)誤碼請(qǐng)參見(jiàn) 下載賬單API (opens new window)接口文檔。