銀行卡實名認(rèn)證接口技術(shù)規(guī)范

1、深圳市超彩網(wǎng)絡(luò)信息有限公司 熱線電話超彩官網(wǎng)： / 9/9銀行卡實名認(rèn)證接口技術(shù)規(guī)范文件狀態(tài)： 草稿 正式發(fā)布 正在修改文件標(biāo)識：當(dāng)前版本：1.1作 者：張有偉完成日期：2017-1-4目 錄 TOC o 1-3 h z u HYPERLINK l _Toc456596863 1 適用范圍 PAGEREF _Toc456596863 h 3 HYPERLINK l _Toc456596864 2銀行卡實名認(rèn)證接口 PAGEREF _Toc456596864 h 3 HYPERLINK l _Toc456596865 接口流程介紹 PAGEREF _Toc45659

2、6865 h 3 HYPERLINK l _Toc456596866 2.1二元素實名認(rèn)證： PAGEREF _Toc456596866 h 4 HYPERLINK l _Toc456596867 2.1.1輸入?yún)?shù) PAGEREF _Toc456596867 h 4 HYPERLINK l _Toc456596868 2.1.1輸出結(jié)果 PAGEREF _Toc456596868 h 4 HYPERLINK l _Toc456596869 2.2三元素實名認(rèn)證： PAGEREF _Toc456596869 h 5 HYPERLINK l _Toc456596870 2.2.1輸入?yún)?shù) PAG

3、EREF _Toc456596870 h 5 HYPERLINK l _Toc456596871 2.2.1輸出結(jié)果 PAGEREF _Toc456596871 h 5 HYPERLINK l _Toc456596872 2.3四元素實名認(rèn)證： PAGEREF _Toc456596872 h 6 HYPERLINK l _Toc456596873 2.3.1輸入?yún)?shù) PAGEREF _Toc456596873 h 6 HYPERLINK l _Toc456596874 2.3.1輸出結(jié)果 PAGEREF _Toc456596874 h 6 HYPERLINK l _Toc456596875 3

4、銀行卡實名查詢數(shù)量接口： PAGEREF _Toc456596875 h 7 HYPERLINK l _Toc456596876 3.1輸入?yún)?shù) PAGEREF _Toc456596876 h 7 HYPERLINK l _Toc456596877 3.2輸出結(jié)果 PAGEREF _Toc456596877 h 7 HYPERLINK l _Toc456596878 4 返回結(jié)果resp_code PAGEREF _Toc456596878 h 81 適用范圍 如今隨著互聯(lián)網(wǎng)產(chǎn)業(yè)的多元化發(fā)展，尤其是互聯(lián)網(wǎng)金融，O2O，移動支付，共享經(jīng)濟(jì)等新興商業(yè)形式的興起，企業(yè)對實名認(rèn)證業(yè)務(wù)的數(shù)據(jù)形式和數(shù)據(jù)質(zhì)

5、量有了更高的需求。2銀行卡實名認(rèn)證接口 接口流程介紹接口地址：HYPERLINK:99/gway/httpRealNameCheck.action返回格式：JSON請求方式：GET/POST接口作用：對外提供給用戶，進(jìn)行實名校驗。需要IP綁定，只能在綁定的IP上訪問接口。 2.1二元素實名認(rèn)證：2.1.1輸入?yún)?shù)請求示例：URL?code=賬號&pass=密碼&goodsNo=業(yè)務(wù)編號& cardNum=銀行卡號&name=姓名&phoneNum=預(yù)留手機(jī)號參數(shù)名參數(shù)類型描述處理要求codestring實名驗證業(yè)務(wù)賬號必填passstring賬號密碼必填goodsNostring業(yè)務(wù)編號必填c

6、ardNumstring持卡人銀行卡號必填namestring持卡人姓名（姓名UTP-8格式）二者必填一項phoneNumString銀行預(yù)留手機(jī)號2.1.1輸出結(jié)果返回結(jié)果報文json： orderNumber:1601051531229446176,resp_code:10000,resp_msg:一致 orderNumber：交易編號resp_code:狀態(tài)碼“10000”成功resp_msg：響應(yīng)信息，描述錯誤信息參數(shù)名參數(shù)類型描述resp_codestring“10000”認(rèn)證成功，其他失敗原因描述請參閱“返回結(jié)果”orderNumberstring交易編號，查詢完成后提供作為交易標(biāo)

7、識resp_msgstring 響應(yīng)信息，描述錯誤信息，可為空，僅供參考！2.2三元素實名認(rèn)證：2.2.1輸入?yún)?shù)請求示例：URL?code=賬號&pass=密碼&goodsNo=業(yè)務(wù)編號&name=姓名&idCard=身份證& cardNum=銀行卡號參數(shù)名參數(shù)類型描述處理要求codestring實名驗證業(yè)務(wù)賬號必填passstring賬號密碼必填goodsNostring業(yè)務(wù)編號必填namestring持卡人姓名（UTP-8格式）必填idCardstring持卡人18位身份證號碼必填cardNumstring持卡人銀行卡號必填2.2.1輸出結(jié)果返回結(jié)果報文json： orderNumber

8、:1601051531229446176,resp_code:10000,resp_msg:一致 orderNumber：交易編號resp_code:狀態(tài)碼“10000”成功resp_msg：響應(yīng)信息，描述錯誤信息參數(shù)名參數(shù)類型描述resp_codestring“10000”認(rèn)證成功，其他失敗原因描述請參閱“返回結(jié)果”orderNumberstring交易編號，查詢完成后提供作為交易標(biāo)識resp_msgstring 響應(yīng)信息，描述錯誤信息，可為空，僅供參考！2.3四元素實名認(rèn)證：2.3.1輸入?yún)?shù)請求示例：URL?code=賬號&pass=密碼&goodsNo=業(yè)務(wù)編號&name=姓名&idC

9、ard=身份證&cardNum=銀行卡號& phoneNum=手機(jī)號碼參數(shù)名參數(shù)類型描述處理要求codestring實名驗證業(yè)務(wù)賬號必填passstring賬號密碼必填goodsNostring業(yè)務(wù)編號必填namestring持卡人姓名（UTP-8格式）必填idCardstring持卡人18位身份證號碼必填cardNumstring持卡人銀行卡號必填phoneNumstring銀行預(yù)留手機(jī)號必填2.3.1輸出結(jié)果返回結(jié)果報文json： orderNumber:1601051531229446176,resp_code:10000,resp_msg:一致 orderNumber：交易編號resp

10、_code:狀態(tài)碼“10000”成功resp_msg：響應(yīng)信息，描述錯誤信息參數(shù)名參數(shù)類型描述resp_codestring“10000”認(rèn)證成功，其他失敗原因描述請參閱“返回結(jié)果”orderNumberstring交易編號，查詢完成后提供作為交易標(biāo)識resp_msgstring 響應(yīng)信息，描述錯誤信息，可為空，僅供參考！3銀行卡實名查詢數(shù)量接口：3.1輸入?yún)?shù)請求示例：http:/ :99/gway/queryBusinessCount.action?code=賬號&pass=密碼&goodsNo=業(yè)務(wù)編號參數(shù)名參數(shù)類型描述處理要求codestring實名驗證業(yè)務(wù)賬號必填passstring

11、賬號密碼必填goodsNostring業(yè)務(wù)編號必填3.2輸出結(jié)果返回結(jié)果報文json： count:123,resp_code:10000count：數(shù)量resp_code:狀態(tài)碼參數(shù)名參數(shù)類型描述resp_codestring“10000”成功，其他失敗原因描述請參閱“返回結(jié)果”countstring 賬號查詢數(shù)量4 返回結(jié)果resp_code 代碼狀態(tài)意義10000成功認(rèn)證成功1000001失敗認(rèn)證失敗C1失敗賬號不正確C2失敗賬號密碼不對C3失敗未開通實名驗證C4失敗實名驗證可用次數(shù)不足C5失敗實名驗證查詢時間范圍不滿足一周內(nèi)C6失敗實名驗證ip校驗不通過C7失敗查詢完成C8失敗查詢?nèi)掌跅l件不充足C9失敗查詢結(jié)果為空C10失敗查詢異常C11失敗用戶被禁用C12失敗實名認(rèn)證業(yè)務(wù)禁用C13失敗實名認(rèn)證業(yè)務(wù)不存在C14失敗手機(jī)號碼交易失敗C