Appearance
业务交易接口
- 本章节描述商户和金运通实名认证实际业务来往需要用到的接口。
- 本类交易用于为商户提供身份校验服务，如：身份证校验、银行卡校验、手机号校验等。
银行卡认证TR4001
交易说明
用于提供银行卡的三要素实名认证，认证要素包括：银行卡号、身份证号、姓名、银行卡类型、银行编号（可选）等。
交易代码
TR4001
使用时机
需要验证银行卡与身份证信息是否一致，需要判断银行卡是否可以用于消费、转账、投资理财。
前置条件
开通平台商户
请求字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 银行卡号 | cardNo | CHAR(30) | M | |
| 2. | 银行编码 | bankCode | CHAR(8) | O | 银行卡所属银行的编码，为空时，后台根据卡号规则查询 不为空时，取值见“银行编码” |
| 3. | 证件类型 | certType | CHAR(2) | O | 如果不输入，则默认身份证类型； 01：身份证 |
| 4. | 证件号码 | idNo | CHAR(18) | M | 银行卡开户人的证件号 |
| 5. | 姓名 | idName | CHAR(30) | M | 客户证件对应的姓名 |
| 6. | 请求终端类型 | terminalType | CHAR(2) | O | 商户使用验证接口的终端类型： 01 APP，02 WAP，03 WEB，04 SIM卡，05 VI-POS，06 SD卡 |
| 7. | 银行卡类型 | bankCardType | CHAR(2) | M | D 借记卡 C 贷记卡 A 全部（如果商户平台借记卡贷记卡都支持的话传A） |
响应字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 银行卡号与身份证号是否一致 | isBcnAndIdnConform | CHAR(1) | 非必输 | 以respCode为准，S0000000时认证成功，其他认证失败 |
| 2. | 银行卡名称 | bankName | CHAR(32) | 必输 |
身份证认证TR4002
交易说明
用于提供身份证的二要素实名认证，认证要素包括：身份证号、姓名。
交易代码
TR4002
使用时机
需要验证身份证号和姓名是否一致
前置条件
开通商户
请求字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 证件类型 | certType | CHAR(2) | O | 如果不输入，则默认身份证类型； 01：身份证 |
| 2. | 证件号码 | idNo | CHAR(18) | M | 身份证号 |
| 3. | 姓名 | idName | CHAR(30) | M | 身份证对应的姓名 |
响应字段
无，通过报文头返回码返回交易结果，respCode为S0000000表示认证成功
四要素认证TR4003
交易说明
用于提供银行卡的四要素实名认证，认证要素包括：银行卡号、身份证号、姓名、银行卡类型，银行编号（可选），手机号等。
交易代码
TR4003
使用时机
需要验证银行卡与身份证信息是否一致，需要判断银行卡是否可以用于消费、转账、投资理财
前置条件
开通商户业务
请求字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 银行卡号 | cardNo | CHAR(30) | M | |
| 2. | 银行编码 | bankCode | CHAR(8) | O | 银行卡所属银行的编码，为空时，后台根据卡号规则查询 不为空时，取值见“银行编码” |
| 3. | 证件类型 | certType | CHAR(2) | O | 如果不输入，则默认身份证类型； 01：身份证 |
| 4. | 证件号码 | idNo | CHAR(18) | M | 银行卡开户人的证件号码 |
| 5. | 姓名 | idName | CHAR(30) | M | 银行卡开户姓名 |
| 6. | 请求终端类型 | terminalType | CHAR(2) | O | 商户使用验证接口的终端类型 01 APP，02 WAP，03 WEB，04 SIM卡，05 VI-POS，06 SD卡 |
| 7. | 银行卡类型 | bankCardType | CHAR(2) | M | D 借记卡 C 贷记卡 A 全部（如果商户平台借记卡贷记卡都支持的话传A） |
| 8. | 手机号码 | phoneNo | CHAR(11) | M | 银行卡开户预留的手机号码 |
响应字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 银行卡名称 | bankName | CHAR(32) | 必输 |
四要素认证短信下发TR4004
交易说明
用于提供银行卡的实名认证，认证要素包括：银行卡号、身份证号、姓名、银行卡交易类型，银行编号(可选)，手机号等。
交易代码
TR4004
使用时机
需要验证银行卡与身份证信息是否一致，如果一致则向银行预留手机号发送短信验证码确认该笔认证
前置条件
开通商户业务
请求字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 银行卡号 | cardNo | CHAR(30) | M | |
| 2. | 银行编码 | bankCode | CHAR(8) | O | 银行卡所属银行的编码，为空时，后台根据卡号规则查询 不为空时，取值见“银行编码” |
| 3. | 证件号码 | idNo | CHAR(18) | M | 银行卡开户人的身份证号 |
| 4. | 证件类型 | certType | CHAR(2) | O | 如果不输入，则默认身份证类型； 01：身份证 |
| 5. | 姓名 | idName | CHAR(30) | M | 身份证对应的姓名 |
| 6. | 请求终端类型 | terminalType | CHAR(2) | O | 商户使用验证接口的终端类型： 01 APP，02 WAP，03 WEB，04 SIM卡，05 VI-POS，06 SD卡 |
| 7. | 银行卡类型 | bankCardType | CHAR(2) | M | D 借记卡 C 贷记卡 A 全部（如果商户平台借记卡贷记卡都支持的话传A） |
| 8. | 手机号码 | phoneNo | CHAR(11) | M | 银行卡开户预留的手机号码 |
响应字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 绑卡订单号 | bindCardId | VARCHAR(32) | M | 报文头respCode为S0000000时有值 |
四要素认证短信确认TR4005
交易说明
用于确认是持卡人本人进行认证，成功后即可绑定商户平台。
交易代码
TR4005
使用时机
调用TR4004且收到短信验证码后使用该接口来确认是本人操作实名。
前置条件
开通商户且调用TR4004接口
请求字段
| 序号 | 字段名称 | Json字段标签 | 类型 | 属性 | 取值说明 |
|---|---|---|---|---|---|
| 1. | 绑卡订单号 | bindCardId | VARCHAR(32) | M | 用于确认进行四要素认证的校验订单 |
| 2. | 短信验证码 | verifyCode | CHAR(10) | M | 手机号接收的验证码 |
| 3. | 手机号码 | phoneNo | CHAR(11) | M | 银行卡开户预留的手机号码 |
响应字段
无，结果以报文头的respCode判断，为S0000000时代表认证成功，其他为失败！