身份验真- 墨西哥

身份证验真是用于验证用户身份证信息相关的真实性。

API 方式

Base URL

API

URL请求方式Content-Type输出格式字符集
api-base-url?partner_code=xxx&partner_key=xxxPOSTapplication/jsonJSONUTF-8
认证参数
字段类型含义建议备注
partner_codeString合作方标识必须由 TD 分配
partner_keyString合作方密钥必须由 TD 分配

请求参数

字段类型含义建议备注
id_numberString身份证件 ID 号码必须ID number
id_typeString身份证件 ID 类型必须ID 类型枚举值: 国民身份证:national_id
countryString国家必须国家,必填. 两位国家码,符合 ISO 3166 标准。目前支持:墨西哥(MX)

响应参数

字段类型含义建议备注
codeIntegerAPI 状态码必须
messageString状态信息必须在 API 异常状态下会输出具体的异常原因
sequence_idString响应唯一码必须用于跟踪每次请求记录的唯一标识
resultString结果必须枚举值:
成功:success
失败:fail
id_infoJSONObjectID信息条件必须code=200,返回该字段.
  • Id_info数据结构
    字段字段类型描述
    curpStringCURP(ID number)
    nombreStringName
    apellido_paternoStringLast name
    apellido_maternoStringMother's last name
    sexoStringGender
    fecha_nacimientoStringbirth date, format as DD/MM/YYYY
    pais_nacimientoStringCountry of birth
    estado_nacimientoStringState of birth
    datos_doc_probatorioObjectEvidence data
    estatus_curpStringStatus of CURP, Active or Not Active
datos_doc_probatorio数据结构
字段字段类型描述
entidad_registroStringRegistry entity
clave_municipio_registroStringMunicipality registry key
anio_regStringRegistry year
clave_entidad_registroStringEntity registry key

API 状态码

CodeMessage描述是否收费
200success调⽤成功
301Service not purchased未购买此服务
302Traffic blocked流量已被禁用
303Traffic insufficient流量不足
304Service expired服务已过期
305Daily maximum volume reached日流量已封顶
600Service Temporarily Unavailable限流错误
11350Internal error系统错误
11301{parameter} empty{参数}为空
11304The country partner located is not open国家不支持
11340{parameter} error{参数}错误
12701CURP not existcurp不存在
12702CURP format errorcurp格式错误
12703Invalid CURP无效的curp

响应示例

  • 入参示例:

    {
      "country": "MX",
      "id_type": "national_id",
      "id_number": "xxxxxxxxxx"
    }
    
  • 业务请求成功

{
    "result": "success",
    "code": 200,
    "sequence_id": "53b63090c0374cad82f26a5aa4f8991e",
    "message": "success",
    "id_info": {
        "datos_doc_probatorio": {
            "clave_entidad_registro": "09",
            "entidad_registro": "DISTRITO FEDERAL",
            "municipio_registro": "",
            "clave_municipio_registro": "010",
            "anio_reg": "1978"
        },
        "fecha_nacimiento": "22/08/1978",
        "estatus_curp": "Active",
        "nombre": "ARTURO",
        "apellido_paterno": "MARRUENDA",
        "apellido_materno": "HUESCA",
        "estado_nacimiento": "DISTRITO FEDERAL",
        "pais_nacimiento": "MEXICO",
        "sexo": "HOMBRE",
        "curp": "MAHA78****HDFRSR07"
    }
}
  • 业务请求不成功

    {
        "result": "fail",
        "code": 11301,
        "sequence_id": "69b57131b6fb********61ccba118b60",
        "message": "Country error"
    }