工商实名四要素-简版

企业四要素核验(简版返回码)。

产品概述

通过企业名称、统一社会信用代码/注册号、法人代表姓名、法人代表身份证号的一致性来进行身份核验。

  • 响应时间:平均 300ms

接口说明

  • 请求地址:由服务方提供
  • 请求方式:HTTP POST
  • 请求格式:application/x-www-form-urlencoded
  • 响应格式:application/json
  • 超时时间:默认 10s

请求参数

参数描述是否必填说明
parMerCode主商户号商户一级账号,由服务方提供
merAcct商户账号商户二级账号,由服务方提供
appKey商户密钥加签所需密钥,由服务方提供,入参不传此值
productType产品类型见各接口附录
merserialNo商户流水号最长 36 位,建议上送便于双方查询交易
signature签名值报文加签后的值,见通用约定
companyName企业名称需要验证的企业名称
regNo统一社会信用代码/注册号
userName姓名需要认证的法人姓名
idNum证件号需要认证的法人证件号

请求示例

POST 请求体为 application/x-www-form-urlencoded非 JSON),appKey 不入参。Body 示例:

parMerCode=主商户号&merAcct=商户账号&productType=PMV&merserialNo=商户流水号&companyName=企业名称&regNo=统一社会信用代码&userName=法人姓名&idNum=法人身份证号&signature=加签后的签名值

响应参数

参数描述是否必返说明
respCode返回码见各接口附录
respMsg返回信息见各接口附录
datadata 数据域返回请求信息及我司订单号

data 数据域

子参描述是否必返说明
parMerCode主商户号原样返回
merAcct商户账号原样返回
productType产品类型原样返回
transCode交易流水号我司交易流水号(订单号)
companyName企业名称原样返回
regNo统一社会信用代码/注册号原样返回
userName姓名原样返回
idNum证件号原样返回

应答示例

{"respCode": "PMV00", "respMsg": "核验一致", "data": {"parMerCode": "主商户号", "merAcct": "商户账号", "productType": "PMV", "transCode": "交易流水号", "companyName": "企业名称", "regNo": "统一社会信用代码/注册号", "userName": "姓名", "idNum": "证件号"}}

附录

产品类型字典

产品类型枚举值产品类型含义
PMV企业实名四要素认证

返回码及信息字典

返回码返回信息是否计费
PMV00核验一致
PMV02法人姓名不匹配
PMV03法人 ID 不匹配
PMV88企业名称或统一社会信用代码错误
PMV99无法校验或无此记录
ID法人身份证 ID 错误
NM法人姓名校验不通过
CN核验不一致,公司名称有误
ER交易异常
OT交易超时/资源方超时
SE系统异常
DE请求数据有误
SF验签失败
PD权限不足
AR账户余额不足

加签说明与完整调用 Demo 见通用约定