微信支付接口說明書

1、二維碼支付接口說明書微信支付說明書V1.02016年04月修訂頁編號(hào)章節(jié)名稱修訂內(nèi)容簡述修訂日期修訂前版本號(hào)修訂后版本號(hào)修訂人批準(zhǔn)人1全文創(chuàng)建全文2016年04月16日V1.0曾軍 2交易回調(diào)通知通知交易狀態(tài)2016年04月28日曾軍 3同步商戶簽約費(fèi)率同步商戶簽約費(fèi)率2016年06月01日曾軍1.1. 接口說明通過http post方式交互，請求報(bào)文為json格式，請求報(bào)文由商戶號(hào)、交易命令、交易信息、signature(簽名)組成，交易信息的內(nèi)容需加簽，整個(gè)交易信息需要進(jìn)行加密，返回格式為json。1.2. 數(shù)據(jù)流程客戶端處理流程1. 拼裝報(bào)文，對(duì)msg字段加簽 放入signature字段

2、中2. 對(duì)拼裝后報(bào)文加密并發(fā)送3. 接收服務(wù)器響應(yīng)，解密4. 對(duì)于接收的報(bào)文驗(yàn)證簽名。1.3. 安全說明報(bào)文會(huì)對(duì)敏感字段（msg）進(jìn)行MD5WITHRSA簽名，并對(duì)整個(gè)報(bào)文RSA加密，加密說明見相關(guān)demo。1.4. 數(shù)據(jù)類型規(guī)則1.4.1. 出現(xiàn)次數(shù)1) 0.1數(shù)據(jù)元值域可填，且出現(xiàn)一次，節(jié)點(diǎn)中必須出現(xiàn)，可空；2) 0.n數(shù)據(jù)元值域可填，且可出現(xiàn)多次； 3) 1.1數(shù)據(jù)元值域必填，且出現(xiàn)一次； 4) 1.n數(shù)據(jù)元值域必填，且可出現(xiàn)多次1.4.2. 節(jié)點(diǎn)數(shù)據(jù)類型1) s=字符類型，例：s.60 字符串60個(gè)長度2) n=數(shù)值類型，例：n.18,4 數(shù)值包含小數(shù)點(diǎn)共18位，其中包含4位小數(shù)3)

3、date=日期類型，全文要求日期格式為 yyyyMMddHHmmss1.4.3. 相關(guān)數(shù)據(jù)詳解1) 時(shí)間字段：時(shí)間字段如無特殊說明，則格式為yyyyMMddHHmmss1.5. 交易碼列表1.5.1. 基礎(chǔ)功能序號(hào)交易命令代碼功能1.register注冊普通POST HTTP方式請求詳見Demo2.tb_DownLoadKey下載密鑰3.tb_verifyInfo驗(yàn)卡4.tb_WeixinPay二維碼支付5.tb_OrderConfirm查詢訂單狀態(tài)注意： 接口全部按照加密傳輸; 加密格式為："data":"加密信息","sign

4、ature":"簽名" 加密信息："msg":""參數(shù)":"",." 1.6. 接口信息說明1.6.1. 注冊商戶接口請求報(bào)文：序號(hào)中文名稱字段名稱出現(xiàn)次數(shù)數(shù)據(jù)類型及長度說明1帳號(hào)account1.1s.11手機(jī)號(hào)碼 必填2密碼pass1.1s.6>=6位(英文/數(shù)字) 必填3推廣碼code1.1s.6按照下放信息填寫 必填4下放商戶標(biāo)識(shí)cbzid1.1s.50按照下放信息填寫 必填備注：普通HTTP POST交互,詳見demo; 推廣碼和下放商戶標(biāo)識(shí)必須填寫下放資料里面對(duì)應(yīng)的信

5、息;響應(yīng)報(bào)文序號(hào)標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型及長度說明1respCode返回碼1.1s.5詳見返回碼說明2respInfoc1.1s.601.6.2. 下載密鑰接口(tb_DownLoadKey)請求報(bào)文序號(hào)標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型及長度說明1orderCode交易命令1.1s.5必填2account帳號(hào)1.1s.11必填3password密碼1.1s.6必填響應(yīng)報(bào)文序號(hào)標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型及長度說明1respCode返回碼1.1s.5詳見返回碼說明2respInfo返回碼描述1.1s.53privatekey私鑰1.1s.800簽名信息，解密信息1.6.3. 驗(yàn)卡接口(tb_ve

6、rifyInfo)請求報(bào)文序號(hào)標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型及長度說明1orderCode交易命令1.1s.5必填2account帳號(hào)1.1s.11必填3real_name戶名1.1s.4真實(shí)姓名 必填4cmer商戶名稱1.1s.10必填5card_type卡類型1.1s.1參考demo默認(rèn)值 必填6card_no卡號(hào)1.1s.30只允許個(gè)人卡號(hào) 必填7cert_type證件類型1.1s.1參考demo默認(rèn)值 必填8cert_no證件號(hào)1.1s.30必填9mobile開戶時(shí)綁定手機(jī)號(hào)1.1s.11非必填11location開戶城市1.1s.10非必填12cert_correct身份證正面圖片1.

7、1s.20圖片地址 非必填13cert_opposite身份證背面圖片1.1s.20圖片地址 非必填 14cert_meet手持身份證圖片1.1s.20圖片地址 非必填15card_correct銀行卡正面圖片1.1s.20圖片地址 非必填16card_opposite銀行卡背面圖片1.1s.20圖片地址 非必填響應(yīng)報(bào)文序號(hào)標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型及長度說明1respCode返回碼1.1s.5詳見返回碼說明2respInfo返回碼描述1.1s.501.6.4. 二維碼支付接口(tb_WeixinPay)請求報(bào)文序號(hào)標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型及長度說明1orderCode交易命令1.1s.

8、5必填1account帳號(hào)1.1s.50必填2amount金額1.1s.50單位：分 必填3info備注1.1s.50附加信息默認(rèn)為空 非必填響應(yīng)報(bào)文序號(hào)標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型及長度說明1respCode返回碼1.1s.5詳見返回碼說明2QRcodeURL二維碼支付地址1.1s.703orderId訂單號(hào)1.1s.101.6.5. 訂單狀態(tài)查詢接口(tb_OrderConfirm)請求報(bào)文序號(hào)標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型及長度說明1orderCode交易命令1.1s.5必填2account帳號(hào)1.1s.11必填3orderId訂單號(hào)1.1s.15交易接口返回的orderId 必填響應(yīng)報(bào)文

9、序號(hào)標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型及長度說明1respCode返回碼1.1s.5詳見返回碼說明2respInfo返回碼描述1.1s.503orderId訂單號(hào)1.1s.151.6.6. 交易回調(diào)通知返回信息序號(hào)標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型及長度說明1orderId訂單號(hào)1.1s.52respCode返回碼1.1s.503respInfo返回碼描述1.1s.15注意：發(fā)送方式普通POST表單，request 接收;1.6.7. 同步商戶簽約費(fèi)率(xy_ChangeRate)請求報(bào)文序號(hào)標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型及長度說明1orderCode交易命令1.1s.5必填2account帳號(hào)1.1s.1

10、1必填3password密碼1.1s.11必填4rate簽約費(fèi)率1.1s.5必填例如：0.005千分比5cbzid下發(fā)商戶標(biāo)識(shí)1.1s.11必填響應(yīng)報(bào)文序號(hào)標(biāo)記中文名稱出現(xiàn)次數(shù)數(shù)據(jù)類型及長度說明1respCode返回碼1.1s.5詳見返回碼說明2respInfo返回碼描述1.1s.501.7. 返回碼及描述響應(yīng)碼響應(yīng)信息備注100022ERRORCBZIDcbzid錯(cuò)誤100011ERRORCODE推薦碼錯(cuò)誤100015ERRORALREADYREGISTERED賬號(hào)已經(jīng)注冊100016ERROR注冊系統(tǒng)異常100034ERRORDECRYPT解密失敗100035ERRORCHECKCARD驗(yàn)

11、卡失敗300000ERRORAUDIT審核失敗100036ERROR驗(yàn)卡系統(tǒng)異常100037ERRORAUDITING審核中不允許修改100038ERRORSYNC同步中不允許修改100039ERRORDECRYPT解密失敗100040ERRORCHECKCARD驗(yàn)卡失敗100043ERROR驗(yàn)卡系統(tǒng)異常100001ERRORNOTAUDITED商戶未審核100002ERRORNOCHECKCARD商戶未驗(yàn)卡100003ERRORCHANNELRSA密鑰錯(cuò)誤100000ERROR交易系統(tǒng)異常100089ERRORORDER訂單號(hào)錯(cuò)誤100032ERROR訂單確認(rèn)系統(tǒng)異常100026ERRORNOTEXISTORPASS商戶不存在或者密碼錯(cuò)誤100027ERROR獲取密鑰系統(tǒng)異常100050ERRORPARAMS信息有誤100052ERRORRATE簽約費(fèi)率錯(cuò)誤100054ERRORJCMSTATE商戶未審核100055ERROR同步商戶簽約費(fèi)率異常000000SUCCESS成功1.8. 對(duì)賬文件1.8.1. 對(duì)賬文件說明服務(wù)器每日9：0