巴西身份核验

Verifik 身份核验 API 使用 Cadastro de Pessoas Físicas（CPF） 认证巴西国民，旨在简化 KYC、防范欺诈并满足合规要求。

本 API 核验什么？

连接官方登记数据以核验：

• 全名与 CPF 号码：支持 Cadastro de Pessoas Físicas（CPF）。
• 身份一致性：提供的姓名是否与 CPF 号码一致。
• 出生日期：出生日期是否与官方记录一致。

API 参考

Endpoint

https://api.verifik.co/v2/br/cedula

将巴西自然人的 CPF 与官方来源比对。请提供 CPF、出生日期（DD/MM/YYYY）以及带或不带分隔符的证件号码；数据一致时，响应返回规范化姓名组成部分与标识符。适用于 KYC、反欺诈与受监管入驻。

请求头（Headers）

名称	取值
Accept	application/json
Authorization	Bearer <token>

参数（Parameters）

名称	类型	必填	描述
documentType	string	是	证件类型。允许值：CPF。
documentNumber	string	是	CPF 号码（可含或不含分隔符）。
dateOfBirth	string	是	出生日期，格式：DD/MM/YYYY。

请求（Request）

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/br/cedula", {
  params: { documentType: "CPF", documentNumber: "012.345.678-01", dateOfBirth: "17/02/2002" },
  headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/br/cedula"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CPF", "documentNumber": "012.345.678-01", "dateOfBirth": "17/02/2002"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

响应（Response）

200

{
  "data": {
    "arrayName": [
      "RAISSA",
      "LARA",
      "ROCHA",
      "ALVES",
      "FERREIRA"
    ],
    "dateOfBirth": "2002-02-17",
    "documentNumber": "01916658601",
    "documentType": "CPF",
    "firstName": "RAISSA LARA ROCHA",
    "fullName": "RAISSA LARA ROCHA ALVES FERREIRA",
    "lastName": "ALVES FERREIRA"
  },
  "signature": {
    "dateTime": "October 8, 2025 6:44 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "AMARG"
}

401

{
  "message": "Authentication required",
  "code": "UNAUTHORIZED"
}

403

{
  "message": "Access forbidden",
  "code": "FORBIDDEN"
}

409

{
  "code": "MissingParameter",
  "message": "missing documentType\n"
}

{
  "code": "MissingParameter",
  "message": "missing documentNumber\n"
}

{
  "code": "MissingParameter",
  "message": "missing dateOfBirth\n"
}

{
  "code": "MissingParameter",
  "message": "documentType must be one of: [CPF]"
}

{
  "code": "MissingParameter",
  "message": "dateOfBirth format required: DD/MM/YYYY\n"
}

404

{
  "code": "NotFound",
  "message": "Record not found."
}

备注

• CPF 必须有效；出生日期为必填且须与记录一致。