首信易支付认证接口用于验证个人信息、银行卡信息、企业信息是否匹配、真实和有效
https://apis.5upay.com/rz/auth
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| merchantId | 商户编号 | varchar(9) | 商户在首信易系统唯一身份标识,商户可登录商户后台查看 | M |
| partnerId | 服务商编号 | varchar(9) | 子商户上属服务商商户在首信易系统的唯一身份标识,商户可登录商户后台查看 | C |
| requestId | 订单号 | varchar(50) | 订单号为商户自行拟定，提交的订单号必须在自身平台交易中唯一。首信易支付系统认证成功的订单，商户平台不能以相同的订单号再次提交。 | M |
| authType | 认证类型 | 固定值 | AUTH_USER 实名认证 用于验证身份信息是否真实存在,传递:姓名、身份证 | M |
| AUTH_BANK_CARD 银行卡三要素认证：用于验证卡号、姓名、身份证号码是否一致 | ||||
| AUTH_BANK_CARD_ENHANCE 银行卡四要素认证，用于验证卡号、姓名、身份证号码、手机号是否一致 | ||||
| AUTH_ENTERPRISE_2 企业二要素认证，用于验证企业名称、统一社会信用代码是否一致 | ||||
| AUTH_ENTERPRISE_3 企业三要素认证，用于验证企业名称、统一社会信用代码、法人是否一致 | ||||
| AUTH_ENTERPRISE_4 企业四要素认证，用于验证企业名称、统一社会信用代码是否一致、法人、身份证号码是否一致 | ||||
| name | 姓名 | varchar(50) | 除企业二要素认证外必填 | C |
| idCardNum | 证件号码 | varchar(18) | 实名认证、银行卡认证、企业四要素必填。企业四要素认证时需传入法人身份证号码 | C |
| bankCardNumber | 银行卡号 | varchar(50) | 银行卡认证必填 | C |
| phoneNumber | 银行预留手机号码 | varchar(50) | 企业四要素认证必填 | C |
| enterpriseName | 企业名称 | varchar(50) | 企业认证必填 | C |
| enterpriseOriginCode | 统一社会信用代码 | varchar(18) | 企业认证必填 | C |
| hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 | M |
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 同请求参数 |
| partnerId | 服务商编号 | 同请求参数 |
| requestId | 订单号 | 同请求参数 |
| authType | 认证类型 | AUTH_USER 实名认证 |
| AUTH_BANK_CARD 银行卡三要素认证 | ||
| AUTH_BANK_CARD_ENHANCE 银行卡四要素认证 | ||
| AUTH_ENTERPRISE_2 企业二要素认证 | ||
| AUTH_ENTERPRISE_3 企业三要素认证 | ||
| AUTH_ENTERPRISE_4 企业四要素认证 | ||
| serialNumber | 流水号 | 认证订单流水号，由首信易系统自动生成，每笔认证订单的唯一标识。 |
| status | 状态 | PASS 验证通过(认证信息正常) |
| NOPASS 验证未通过(认证信息有问题) | ||
| NOAUTH 无法认证(该身份信息存在户口迁移或者信息冻结等问题) | ||
| errorMessage | 错误信息 | 错误信息，格式：错误码|错误码说明(通道错误信息) |
| hmac | 参数签名 | 首信易生成的参数签名结果，验签过程请参考解密流程 |