接入前準(zhǔn)備

1. 接入模式選擇

商戶/機(jī)構(gòu)在接入前首先要判斷自己公司注冊區(qū)域適用的接入模式，微信跨境支付目前提供三種接入方式：直連模式、機(jī)構(gòu)模式、普通服務(wù)商模式。

1.1. 直連模式

商戶與微信跨境支付接口直接對接，微信支付直接將交易資金結(jié)算給商戶。該接入模式目前僅在香港及英國開放，具體接入流程及資質(zhì)要求，請參考直連模式入駐指引。

1.2. 機(jī)構(gòu)模式

機(jī)構(gòu)模式下，由收單機(jī)構(gòu)對接微信支付API并二次封裝接口提供給商戶，微信支付會將交易資金結(jié)算給收單機(jī)構(gòu)，由收單機(jī)構(gòu)機(jī)構(gòu)結(jié)算給商戶。目前該接入模式在所有微信跨境支付開放接入的區(qū)域均可使用，也是微信跨境支付主要的對接方式。具體接入流程及資質(zhì)要求，請參考機(jī)構(gòu)模式入駐指引。若你想了解所在區(qū)域已和微信支付合作的收單機(jī)構(gòu)，可點(diǎn)擊查看。

1.3. 普通服務(wù)商模式

普通服務(wù)商模式下，由普通服務(wù)商對接微信支付API并二次封裝接口提供給商戶。普通服務(wù)商僅處理交易信息流，不觸碰資金流，交易資金將會直接結(jié)算給商戶。該接入模式目前僅在香港開放，具體接入流程及資質(zhì)要求，請參考普通服務(wù)商模式入駐指引。

請結(jié)合自身實際情況及所在國家或地區(qū)來選擇接入模式。

2. 申請指引

1申請商戶號mch_id

機(jī)構(gòu)或直連商戶在入駐微信支付時，都需要先申請一個收款賬號，該賬號即是mch_id，其申請地址如下： 商戶號申請指引
申請成功后，微信支付會向機(jī)構(gòu)填寫的聯(lián)系郵箱下發(fā)通知郵件，內(nèi)容包含申請成功的mch_id及其登陸賬號密碼，請妥善保存。示例如下：

注意

一個mch_id只能對應(yīng)一個結(jié)算幣種，若需要使用多個幣種收款，需要申請對應(yīng)數(shù)量的mch_id。

2申請APPID

由于微信支付的產(chǎn)品體系全部搭載于微信的社交體系之上，所以直連商戶或機(jī)構(gòu)接入微信跨境支付時，還需要有一個微信社交載體，該載體對應(yīng)的ID即為APPID。

目前機(jī)構(gòu)的社交載體只能是公眾號，請通過以下鏈接申請公眾號： 公眾號申請指引

公眾號申請成功后，機(jī)構(gòu)登陸公眾號平臺即可獲取對應(yīng)的APPID，具體查閱目錄為Development->Basic Configuration-> Official Account development information，如下圖所示。通常情況下，一個機(jī)構(gòu)只需申請一個公眾號即可。

3綁定MCHID與APPID

APPID和mch_id全部申請完畢后，需要建立兩者之間的綁定關(guān)系。
機(jī)構(gòu)可登陸商戶平臺，在頂部tab中選擇Dev Configuration，即可進(jìn)入綁定操作頁面。若平臺提示綁定失敗，可聯(lián)系對應(yīng)bd或助理人員完成綁定。
機(jī)構(gòu)模式下，一個APPID下可綁定多個mch_id，但一個mch_id僅可綁定到一個APPID。

為了便于理解舉例如下：
APPID為社交載體，可以想象它為一個實體個人。
mch_id為收款賬戶，可以想象它為一個銀行賬號。
一個實體個人可以擁有多個銀行賬號，但一個銀行賬號僅可為一個實體個人擁有。

4子商戶入駐

上述步驟操作完成后，即會向機(jī)構(gòu)開放入駐子商戶權(quán)限。

機(jī)構(gòu)可登陸商戶平臺進(jìn)入Institution界面完成子商戶入駐，或使用入駐子商戶API來完成入駐。

3. 開發(fā)參數(shù)配置

3.1. 配置API Key v3

API Key v3主要用于對接口傳輸中的敏感信息進(jìn)行加密及解密，具體加解密規(guī)則可參考敏感信息加解密。

API Key v3配置流程如下

1 登錄微信商戶平臺，進(jìn)入"Account Settings" > "API Security" > "Set APIv3 Secret"目錄，點(diǎn)擊 Set APIv3 secret 。

2輸入APIv3 key，內(nèi)容為32位字符，包括數(shù)字及大小寫字母。點(diǎn)擊 Confirm 以進(jìn)行下一步。

3輸入設(shè)置的Pin code，并獲取短信驗證碼。輸入驗證碼后點(diǎn)擊 OK 即完成設(shè)置。

4點(diǎn)擊Confirm以退出對話框。

5完成

3.2. 下載并配置商戶證書

商戶證書用于機(jī)構(gòu)/直連商戶進(jìn)行傳輸內(nèi)容的簽名和驗簽。

機(jī)構(gòu)可登陸微信商戶平臺，在Account Settings->API Security->API Certificate目錄下載證書

以下為具體下載步驟：

1從2018年底開始，微信支付新入駐機(jī)構(gòu)及商戶都將使用CA簽發(fā)證書，在證書申請頁面上點(diǎn)擊 Apply。

2在彈出窗口內(nèi)點(diǎn)擊 Download 按鈕下載證書工具。

3安裝證書工具并打開，選擇證書需要存儲的路徑后點(diǎn)擊 Request Certificate。

4在商戶平臺彈窗 Apply API Certificate > Obtian Certificate Signing Request 中，點(diǎn)擊 click here 以復(fù)制商戶信息。

5在證書工具中，將復(fù)制的商戶信息黏貼并點(diǎn)擊 Next 。

6獲取請求串

步驟1在證書工具“Copy request string”中，點(diǎn)擊“Copy”以復(fù)制請求串。

步驟2在商戶平臺彈窗“Apply API Certificate” > “Obtian Certificate Signing Request”中，黏貼請求串到輸入框內(nèi)。

步驟3在商戶平臺彈窗“Apply API Certificate” > “Obtian Certificate Signing Request”中，輸入短信驗證碼及登錄密碼。

步驟4在商戶平臺彈窗“Apply API Certificate” > “Obtian Certificate Signing Request”中，點(diǎn)擊“Next”進(jìn)入“Get certificate”頁面。

7獲取證書串

步驟1在商戶平臺彈窗“Apply API Certificate” > “Get Certificate”中，點(diǎn)擊“copy”以獲取證書串。

步驟2在證書工具“Copy request string”中，點(diǎn)擊“Next”進(jìn)入“Paste certificate string”頁面。

步驟3在證書工具“Paste certificate string”中，點(diǎn)擊“Paste”以黏貼從平臺彈窗復(fù)制的證書串。

步驟4在證書工具“Paste certificate string”中，點(diǎn)擊“Next”以生成證書。

8在證書工具“Generate certificate”中，該頁面表示證書已申請成功。點(diǎn)擊 View folder 可打開證書存在的路徑以核驗證書。

9完成

3.3 配置H5支付授權(quán)域名

H5支付產(chǎn)品能力是從微信客戶端外的瀏覽器拉起微信客戶端來完成支付，拉起微信客戶端的頁面所屬域名必須要在微信支付商戶平臺完成配置授權(quán)，否則將無法拉起H5支付。

操作說明

? 若為直連商戶，請登錄微信支付商戶平臺，可進(jìn)入Development Configuration菜單在Payment Authorization Config區(qū)域?qū)uthorized Domain進(jìn)行配置，也可以在Account Setting > Products Application > H5 Payment菜單下點(diǎn)擊config對支付域名進(jìn)行配置。

? 若為機(jī)構(gòu)模式，且機(jī)構(gòu)下的子商戶用于拉起微信客戶端收銀臺的網(wǎng)頁屬于同一目錄下，可將支付目錄配置在機(jī)構(gòu)商戶號下，將對所有子商戶都生效可用，此時請登錄微信支付商戶平臺，進(jìn)入Development Configuration菜單，在Payment Authorization Config區(qū)域?qū)uthorized Domain進(jìn)行配置，具體頁面如下圖所示：

? 若為機(jī)構(gòu)模式，但機(jī)構(gòu)下的子商戶用于拉起微信客戶端收銀臺的網(wǎng)頁屬于不同目錄下，可將支付目錄配置在子商戶號下，將僅對該子商戶號生效，此時請登錄微信支付商戶平臺，進(jìn)入Institution > Sub-Merchant > Application菜單，找到具體要配置的子商戶，點(diǎn)擊Config進(jìn)入配置頁面，找到Payment Authorization Config區(qū)域?qū)υ撟由虘舻腁uthorized Domain進(jìn)行配置，具體頁面如下：

域名配置說明：

? 建議配置主域名，則所有的子域名都將會有權(quán)限。若只配置子域名，則僅該子域名有權(quán)限。即如果配置qq.com，則www.qq.com和music.qq.com都會有權(quán)限。如果配置www.qq.com，只有www.qq.com會有權(quán)限，music.qq.com和pay.qq.com都不會有權(quán)限。