接入前準備

1. 接入模式選擇

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

1.1. 直連模式

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

1.2. 機構模式

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

1.3. 普通服務商模式

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

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

2. 申請指引

1申請商戶號mch_id

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

注意

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

2申請APPID

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

目前機構的社交載體只能是公眾號，請通過以下鏈接申請公眾號： 公眾號申請指引

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

3綁定MCHID與APPID

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

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

4子商戶入駐

上述步驟操作完成后，即會向機構開放入駐子商戶權限。

機構可登陸商戶平臺進入Institution界面完成子商戶入駐，或使用入駐子商戶API來完成入駐。

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

3.1. 配置API Key v3

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

API Key v3配置流程如下

1 登錄微信商戶平臺，進入"Account Settings" > "API Security" > "Set APIv3 Secret"目錄，點擊 Set APIv3 secret 。

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

3輸入設置的Pin code，并獲取短信驗證碼。輸入驗證碼后點擊 OK 即完成設置。

4點擊Confirm以退出對話框。

5完成

3.2. 下載并配置商戶證書

商戶證書用于機構/直連商戶進行傳輸內容的簽名和驗簽。

機構可登陸微信商戶平臺，在Account Settings->API Security->API Certificate目錄下載證書

以下為具體下載步驟：

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

2在彈出窗口內點擊 Download 按鈕下載證書工具。

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

4在商戶平臺彈窗 Apply API Certificate > Obtian Certificate Signing Request 中，點擊 click here 以復制商戶信息。

5在證書工具中，將復制的商戶信息黏貼并點擊 Next 。

6獲取請求串

步驟1在證書工具“Copy request string”中，點擊“Copy”以復制請求串。

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

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

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

7獲取證書串

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

步驟2在證書工具“Copy request string”中，點擊“Next”進入“Paste certificate string”頁面。

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

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

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

9完成