快速開發(fā)

激活商戶后臺

商戶在使用正式的商戶編號進(jìn)行對接前，需要確認(rèn)在入網(wǎng)時的注冊郵箱中已經(jīng)收到商戶后臺激活郵件，并及時激活商戶后臺，激活郵件中的鏈接有時效性，如果鏈接失效，請聯(lián)系商務(wù)經(jīng)理重新發(fā)送激活郵件。

CFCA證書下載與導(dǎo)出

及時聯(lián)系商務(wù)經(jīng)理申請CFCA證書（接口對接中數(shù)據(jù)加解密需要），然后請注意查收郵箱，共兩封，兩碼發(fā)放通知與操作說明，CFCA兩碼郵件有效期14天，如郵件過期或因其他情況導(dǎo)致證書無法下載安裝，請及時聯(lián)系技術(shù)支持，證書使用360瀏覽器或搜狗瀏覽器下載與安裝。

加解密注意事項

為了數(shù)據(jù)安全，首信易支付接口綜合使用了兩種加密方法、兩種簽名方法以及一種排序方法，分別是：CFCA公鑰證書加密、AES加密、SHA1簽名、CFCA私鑰證書簽名和鍵名首字母排序。

1.證書使用規(guī)則:

商戶使用自己的正式商戶編號時，證書使用情況如下：導(dǎo)出的公鑰證書.cer需要上傳至商戶后臺，程序中公鑰使用SDK demo中的公鑰.cer，程序中私鑰pfx以及私鑰密碼換成下發(fā)證書后導(dǎo)出的私鑰.pfx和導(dǎo)出時設(shè)置的私鑰密碼。

2.加密流程簡述：

1. 按a-z順序排列鍵名，對應(yīng)的鍵值中間用#進(jìn)行拼接，示例：1#2#3#（“#”尾加首不加，空值不參與簽名）
2. 進(jìn)行SHA1 簽名
3. 商戶下載導(dǎo)出的CFCA私鑰.pfx對第2步生成的字節(jié)流結(jié)果再簽名, 將結(jié)果做為hmac值
4. 由商戶隨機(jī)生成十六位AES密鑰
5. 用第4步的AES密鑰對加入了第3步hmac后的請求數(shù)據(jù)JSON串進(jìn)行加密
6. 用首信易SDK demo里提供的CFCA公鑰.cer加密第4步的AES密鑰
7. 把第5步加密完成的密文set到請求體里
8. 把merchantId、requestId、encryptKey（第6步加密后得到的數(shù)據(jù)）傳入請求頭
9. http post請求接口

3.解密流程簡述：

返回數(shù)據(jù)和請求數(shù)據(jù)是相同的格式，按照請求流程的逆推進(jìn)行解密以及驗簽。

1. 接收post請求，獲取返回頭的encryptKey ，返回體 data
2. 用商戶下載導(dǎo)出的私鑰.pfx解密第1步的encryptKey 得到十六位的 AES密鑰
3. 用第2步的AES密鑰解密第1步的data
4. 將第3步得到的原數(shù)據(jù) JSON去掉hmac，按a-z順序排列鍵名，對應(yīng)的鍵值中間用#進(jìn)行拼接，示例：1#2#3#（“#”尾加首不加，空值不參與簽名）
5. 進(jìn)行SHA1 簽名
6. 用首信易提供的SDK demo里的CFCA公鑰.cer對第3步得到的數(shù)據(jù)中的hmac進(jìn)行驗簽，即和第5步的結(jié)果比較，以保證數(shù)據(jù)沒有被篡改。

4. 注意：

• 拼接hmac后的JSON經(jīng)AES加密后的密文直接放在data中，data不是JSON也不要嵌套。
• SHA1前要UTF-8編碼。SHA1后的字符串不要進(jìn)行base64，直接簽名。
• Java demo中需要配置公私鑰路徑與商編。