银行卡认证API文档(三、四、六要素认证)商户对接使用
- 接口地址:http://api.34.cn/Bank/SixBank
- 请求方式:HTTP POST
- 请求参数
-
名称 |
类型 |
必填 |
示例值 |
描述 |
AppId |
String |
是 |
10900015 |
您申请的AppId |
CardNo |
String |
是 |
624566987112245687 |
银行卡卡号(以上范例为虚拟,非真实存在) |
Cvv2 |
String |
是 |
1234 |
信用卡安全码 |
Name |
String |
是 |
张三 |
要检测的身份证姓名 |
Identity |
String |
是 |
350568187605231156 |
身份证账号(以上范例为虚拟,非真实存在) |
Mobile |
String |
是 |
15980123456 |
手机号码(以上范例为虚拟,非真实存在) |
Identity |
String |
是 |
350568187605231156 |
身份证账号(以上范例为虚拟,非真实存在) |
ValidDate |
String |
是 |
1220 |
信用卡有效期(格式:mmyy 如:0919) |
Sign |
String |
是 |
c52a17c89l8jfa6354afb62a9f2bb2dd |
签名签名方式 |
- 返回参数
-
返回参数为单一字符串,情景如下: |
yes |
代表六要素匹配 |
no |
代表六要素不匹配
|
err: |
代表发生错误 |
- 签名方式
- 签名由当前发送短信的参数,组成“待签字符串”之后,对“待签字符串”进行MD5(32位)编码,得到签名内容
- 待签字符串
- “AppId + CardNo + Cvv2 + Identity + Mobile + Name + ValidDate + 用户密钥”组成的字符串,请注意前后顺序!!
- 用户密钥
- 此密钥由平台提供,请妥善保管,防止泄露。如有不明,可咨询平台客服
- 错误代码
-
Code |
描述 |
00 |
商户帐户余额不足 |
02 |
商户短信单价未设置 |
04 |
未设置业务员短信单价 |
06 |
商户短信单价小于业务员短信单价 |
07 |
套餐内可用短信数量不足 |
09 |
业务员的短信单价低于系统成本单价 |
11 |
系统的短信成本大于商户的短信成本 |
12 |
系统成本未设置 |
13 |
通知类短信业务员所配置的单价高于套餐内短信的单价 |
14 |
商户帐户上剩余的套餐数量与套餐明细中剩余的数量不一致 |
15 |
短信模板不存在 |
16 |
短信模板未审核 |
17 |
短信模板未绑定运营商 |
18 |
签名不存在 |
19 |
签名未审核 |
20 |
签名未绑定运营商 |
21 |
资源不存在 |
22 |
资源不隶属该商户 |
23 |
提供的标签数量与模板上的标签数量不一致 |
24 |
标签值不能为空 |
- 接口地址:http://api.34.cn/Bank/FourBank
- 请求方式:HTTP POST
- 请求参数
-
名称 |
类型 |
必填 |
示例值 |
描述 |
AppId |
String |
是 |
10900015 |
您申请的AppId |
CardNo |
String |
是 |
624566987112245687 |
银行卡卡号(以上范例为虚拟,非真实存在) |
Identity |
String |
是 |
350568187605231156 |
身份证账号(以上范例为虚拟,非真实存在) |
Name |
String |
是 |
张三 |
要检测的身份证姓名 |
Mobile |
String |
是 |
15980123456 |
手机号码(以上范例为虚拟,非真实存在) |
Sign |
String |
是 |
c52a17c89l8jfa6354afb62a9f2bb2dd |
签名签名方式 |
- 返回参数
-
返回参数为单一字符串,情景如下: |
yes |
代表四要素匹配 |
no |
代表四要素不匹配
|
err: |
代表发生错误 |
- 签名方式
- 签名由当前发送短信的参数,组成“待签字符串”之后,对“待签字符串”进行MD5(32位)编码,得到签名内容
- 待签字符串
- “AppId + CardNo + Identity + Mobile + Name + 用户密钥”组成的字符串,请注意前后顺序!!
- 用户密钥
- 此密钥由平台提供,请妥善保管,防止泄露。如有不明,可咨询平台客服
- 错误代码
-
Code |
描述 |
00 |
商户帐户余额不足 |
02 |
商户短信单价未设置 |
04 |
未设置业务员短信单价 |
06 |
商户短信单价小于业务员短信单价 |
07 |
套餐内可用短信数量不足 |
09 |
业务员的短信单价低于系统成本单价 |
11 |
系统的短信成本大于商户的短信成本 |
12 |
系统成本未设置 |
13 |
通知类短信业务员所配置的单价高于套餐内短信的单价 |
14 |
商户帐户上剩余的套餐数量与套餐明细中剩余的数量不一致 |
15 |
短信模板不存在 |
16 |
短信模板未审核 |
17 |
短信模板未绑定运营商 |
18 |
签名不存在 |
19 |
签名未审核 |
20 |
签名未绑定运营商 |
21 |
资源不存在 |
22 |
资源不隶属该商户 |
23 |
提供的标签数量与模板上的标签数量不一致 |
24 |
标签值不能为空 |
- 接口地址:http://api.34.cn/Bank/ThreeBank
- 请求方式:HTTP POST
- 请求参数
-
名称 |
类型 |
必填 |
示例值 |
描述 |
AppId |
String |
是 |
10900015 |
您申请的AppId |
CardNo |
String |
是 |
624566987112245687 |
银行卡卡号(以上范例为虚拟,非真实存在) |
Identity |
String |
是 |
350568187605231156 |
身份证账号(以上范例为虚拟,非真实存在) |
Name |
String |
是 |
张三 |
要检测的身份证姓名 |
Sign |
String |
是 |
c52a17c89l8jfa6354afb62a9f2bb2dd |
签名签名方式 |
- 返回参数
-
返回参数为单一字符串,情景如下: |
yes |
代表三要素匹配 |
no |
代表三要素不匹配
|
err: |
代表发生错误 |
- 签名方式
- 签名由当前发送短信的参数,组成“待签字符串”之后,对“待签字符串”进行MD5(32位)编码,得到签名内容
- 待签字符串
- “AppId + CardNo + Identity + Name + 用户密钥”组成的字符串,请注意前后顺序!!
- 用户密钥
- 此密钥由平台提供,请妥善保管,防止泄露。如有不明,可咨询平台客服
- 错误代码
-
Code |
描述 |
00 |
商户帐户余额不足 |
02 |
商户短信单价未设置 |
04 |
未设置业务员短信单价 |
06 |
商户短信单价小于业务员短信单价 |
07 |
套餐内可用短信数量不足 |
09 |
业务员的短信单价低于系统成本单价 |
11 |
系统的短信成本大于商户的短信成本 |
12 |
系统成本未设置 |
13 |
通知类短信业务员所配置的单价高于套餐内短信的单价 |
14 |
商户帐户上剩余的套餐数量与套餐明细中剩余的数量不一致 |
15 |
短信模板不存在 |
16 |
短信模板未审核 |
17 |
短信模板未绑定运营商 |
18 |
签名不存在 |
19 |
签名未审核 |
20 |
签名未绑定运营商 |
21 |
资源不存在 |
22 |
资源不隶属该商户 |
23 |
提供的标签数量与模板上的标签数量不一致 |
24 |
标签值不能为空 |