curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_cpf_facial" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "tax_number=11111111111" \
-F "selfie=@./selfie.jpg"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="BRA",
services=["bra_cpf_facial"],
consent=True,
tax_number="11111111111",
vendor_data="user-1234",
selfie=open("selfie.jpg", "rb"),
)
print(result)
import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "BRA",
services: ["bra_cpf_facial"],
consent: true,
tax_number: "11111111111",
vendor_data: "user-1234",
selfie: await fileFromPath("selfie.jpg"),
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "BRA",
Services: didit.Some([]string{"bra_cpf_facial"}),
Consent: didit.Bool(true),
TaxNumber: didit.String("11111111111"),
VendorData: didit.String("user-1234"),
Selfie: didit.Some(didit.FileFromPath("selfie.jpg")),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.nio.file.Path;
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("BRA")
.services(List.of("bra_cpf_facial"))
.consent(true)
.taxNumber("11111111111")
.vendorData("user-1234")
.selfie(Path.of("selfie.jpg"))
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'BRA',
'services' => ['bra_cpf_facial'],
'consent' => true,
'tax_number' => '11111111111',
'vendor_data' => 'user-1234',
'selfie' => File::fromPath('selfie.jpg'),
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "BRA",
services: ["bra_cpf_facial"],
consent: true,
tax_number: "11111111111",
vendor_data: "user-1234",
selfie: Pathname("selfie.jpg")
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "BRA",
Services = new string[] { "bra_cpf_facial" },
Consent = true,
TaxNumber = "11111111111",
VendorData = "user-1234",
Selfie = FileUpload.FromPath("selfie.jpg"),
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"date_of_birth": "1990-01-01",
"face_match_probability": "Altíssima probabilidade",
"face_match_score": "0.990",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000",
"verifications": {
"identification_number": true
}
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_IMAGE_UNUSABLE",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "INCONCLUSIVE",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"date_of_birth": "1990-01-01",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
🇧🇷 Бразилия
Проверка CPF в Бразилии и сравнение лиц (Datavalid)
Бразилия: CPF и сравнение лиц (Datavalid) через Didit. Проверка по официальной базе Бразилии, оплата за вызов от $0.45, без контрактов и минимальных объёмов.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_cpf_facial" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "tax_number=11111111111" \
-F "selfie=@./selfie.jpg"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="BRA",
services=["bra_cpf_facial"],
consent=True,
tax_number="11111111111",
vendor_data="user-1234",
selfie=open("selfie.jpg", "rb"),
)
print(result)
import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "BRA",
services: ["bra_cpf_facial"],
consent: true,
tax_number: "11111111111",
vendor_data: "user-1234",
selfie: await fileFromPath("selfie.jpg"),
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "BRA",
Services: didit.Some([]string{"bra_cpf_facial"}),
Consent: didit.Bool(true),
TaxNumber: didit.String("11111111111"),
VendorData: didit.String("user-1234"),
Selfie: didit.Some(didit.FileFromPath("selfie.jpg")),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.nio.file.Path;
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("BRA")
.services(List.of("bra_cpf_facial"))
.consent(true)
.taxNumber("11111111111")
.vendorData("user-1234")
.selfie(Path.of("selfie.jpg"))
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'BRA',
'services' => ['bra_cpf_facial'],
'consent' => true,
'tax_number' => '11111111111',
'vendor_data' => 'user-1234',
'selfie' => File::fromPath('selfie.jpg'),
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "BRA",
services: ["bra_cpf_facial"],
consent: true,
tax_number: "11111111111",
vendor_data: "user-1234",
selfie: Pathname("selfie.jpg")
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "BRA",
Services = new string[] { "bra_cpf_facial" },
Consent = true,
TaxNumber = "11111111111",
VendorData = "user-1234",
Selfie = FileUpload.FromPath("selfie.jpg"),
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"date_of_birth": "1990-01-01",
"face_match_probability": "Altíssima probabilidade",
"face_match_score": "0.990",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000",
"verifications": {
"identification_number": true
}
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_IMAGE_UNUSABLE",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "INCONCLUSIVE",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"date_of_birth": "1990-01-01",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
SERPRO Datavalid v4 pf-facial проверяет CPF (обязательно) по данным Receita Federal и сравнивает живое селфи (обязательно) с портретом из CNH, который хранится в Senatran. По желанию проверяет имя и дату рождения. Didit предоставляет этот сервис через
POST /v3/database-validation/, чтобы вы могли сверить отправленные данные с авторитетным источником и получить нормализованные результаты сравнения. Формат ввода: tax_number принимает бразильский CPF (ровно 11 цифр).
Покрытие
- Покрытие: ~50%
- Страна: Бразилия
- ID сервиса:
bra_cpf_facial - Домен данных: Биометрический
- Категория: NationalIDRegistry
Входные данные
| Поле | Обязательно | Пример |
|---|---|---|
tax_number | Да | 11111111111 |
selfie | Да | @./selfie.jpg |
first_name | Нет | John |
last_name | Нет | Doe |
date_of_birth | Нет | 1990-01-01 |
vendor_data | Нет | user-1234 |
- Обязательные входные данные:
tax_number,selfie - Необязательные входные данные:
first_name,last_name,date_of_birth,vendor_data - Согласие: Требуется
- Доступность в сценарии: Доступно в сценарии
- Покрытие: ~50%
- Цена: $0.45 за успешный запрос
Параметры тела запроса
string
по умолчанию:"BRA"
обязательно
Код страны по ISO 3166-1 alpha-3 для этого сервиса баз данных.Пример:
BRAstring
по умолчанию:"bra_cpf_facial"
обязательно
Массив, содержащий ID этого сервиса. Фиксация сервиса ограничивает запрос этой конкретной базой данных.Пример:
bra_cpf_facialboolean
по умолчанию:"true"
обязательно
Явное согласие конечного пользователя на использование этого сервиса.Пример:
truestring
по умолчанию:"11111111111"
обязательно
Налоговый или фискальный идентификационный номер.Пример:
11111111111file
обязательно
Файл изображения селфи для биометрической проверки по базам данных. Допустимые форматы: JPEG, PNG или WebP.Пример:
@./selfie.jpgstring
Имя для проверки.Пример:
Johnstring
Фамилия для проверки.Пример:
Doestring
Дата рождения в формате
YYYY-MM-DD.Пример: 1990-01-01string
по умолчанию:"user-1234"
Ваш стабильный идентификатор пользователя, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и снижать количество ложных срабатываний при поиске дубликатов.Пример:
user-1234Правила ввода и примечания по валидации
- Бразильский CPF (ровно 11 цифр)
tax_numberдолжен содержать только цифры; перед отправкой запроса удалите пробелы, дефисы и знаки пунктуации.- Длина
tax_numberдолжна быть ровно 11 символов.
Как выполнить вызов
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_cpf_facial" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "tax_number=11111111111" \
-F "selfie=@./selfie.jpg"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="BRA",
services=["bra_cpf_facial"],
consent=True,
tax_number="11111111111",
vendor_data="user-1234",
selfie=open("selfie.jpg", "rb"),
)
print(result)
import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.databaseValidation.validate({
issuing_state: "BRA",
services: ["bra_cpf_facial"],
consent: true,
tax_number: "11111111111",
vendor_data: "user-1234",
selfie: await fileFromPath("selfie.jpg"),
});
console.log(result);
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
IssuingState: "BRA",
Services: didit.Some([]string{"bra_cpf_facial"}),
Consent: didit.Bool(true),
TaxNumber: didit.String("11111111111"),
VendorData: didit.String("user-1234"),
Selfie: didit.Some(didit.FileFromPath("selfie.jpg")),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)
import java.nio.file.Path;
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
.issuingState("BRA")
.services(List.of("bra_cpf_facial"))
.consent(true)
.taxNumber("11111111111")
.vendorData("user-1234")
.selfie(Path.of("selfie.jpg"))
.build());
System.out.println(result);
<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->databaseValidation->validate([
'issuing_state' => 'BRA',
'services' => ['bra_cpf_facial'],
'consent' => true,
'tax_number' => '11111111111',
'vendor_data' => 'user-1234',
'selfie' => File::fromPath('selfie.jpg'),
]);
print_r($result->toArray());
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.database_validation.validate(
issuing_state: "BRA",
services: ["bra_cpf_facial"],
consent: true,
tax_number: "11111111111",
vendor_data: "user-1234",
selfie: Pathname("selfie.jpg")
)
puts result.to_h
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
IssuingState = "BRA",
Services = new string[] { "bra_cpf_facial" },
Consent = true,
TaxNumber = "11111111111",
VendorData = "user-1234",
Selfie = FileUpload.FromPath("selfie.jpg"),
});
Console.WriteLine(JsonSerializer.Serialize(result));
Каждый успешный вызов возвращает HTTP 200. Поле outcome_code показывает, что произошло на самом деле: например, реальное несовпадение биометрии (BIOMETRIC_NO_MATCH) отличается от селфи, которое не удалось прочитать (BIOMETRIC_IMAGE_UNUSABLE). Показанный status является статусом функции по умолчанию. Ваши настроенные действия для частичного совпадения и отсутствия совпадения могут его переопределить.MATCH: реестр подтвердил личность, и все проверенные поля совпали.{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"date_of_birth": "1990-01-01",
"face_match_probability": "Altíssima probabilidade",
"face_match_score": "0.990",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000",
"verifications": {
"identification_number": true
}
},
"validation": {
"identification_number": "full_match"
}
}
]
}
NO_MATCH: реестр не вернул совпадений для отправленных данных.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
BIOMETRIC_NO_MATCH - оценка совпадения ниже порога принятия: на селфи изображён другой человек, чем на фото в реестре.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_NO_MATCH",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
BIOMETRIC_IMAGE_UNUSABLE - селфи не удалось обработать (оно пустое, на нём нет лица или оно имеет низкое качество, либо реестр не смог его прочитать). Попросите пользователя переснять селфи.{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "BIOMETRIC_IMAGE_UNUSABLE",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
INCONCLUSIVE - реестр подтвердил CPF (а также имя и дату рождения, которые вы отправили), но сравнить лицо не удалось: для этого CPF нет эталонного фото в реестре, либо селфи нельзя использовать (лицо не найдено, неверный размер изображения, низкое качество или на снимке больше одного лица). Подтвержденные поля остаются в validation, поэтому match_type отражает их, но обязательная проверка лица не завершена, и результат передаётся на рассмотрение. Запросите новое селфи или переходите к верификации документа для людей, у которых в реестре нет фото.{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "INCONCLUSIVE",
"service_id": "bra_cpf_facial",
"service_name": "Brazil - CPF + face match (Datavalid)",
"source_data": {
"date_of_birth": "1990-01-01",
"first_name": "John",
"identification_number": "SAMPLE-ID-12345",
"last_name": "Doe",
"name_match_score": "1.000"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
Возвращаемые данные
Точный набор полей вsource_data зависит от того, что возвращает реестр. Сгенерированный пример для bra_cpf_facial сейчас описывает такую нормализованную структуру:
date_of_birthfirst_nameidentification_numberlast_namename_match_score
Цены и SLA
Бразилия - CPF + сравнение лиц (Datavalid): запросы тарифицируются только тогда, когда Didit получает окончательный результат от источника проверки.- Цена за вызов: $0.45 USD.
- Тарификация: за успешный запрос. Плата не взимается, если реестр недоступен, если обязательные поля отсутствуют или если запрос отклонен до обращения к источнику.
- Задержка: типичное значение p95 < 2 с.
- Доступность: 99.9% в квартал со стороны Didit. Доступность источника данных зависит от страны и набора данных.
Об этом источнике
Это официальный государственный источник: SERPRO Datavalid, которым управляет федеральная служба обработки данных Бразилии. CPF проверяется по базе Receita Federal, а селфи сравнивается с портретом этого человека из Senatran, национального реестра водительских удостоверений. Поскольку портрет берется из записи CNH (водительского удостоверения), биометрическое изображение лица хранится в базе только для тех, кто имеет CNH. Именно поэтому охват составляет примерно 50% взрослого населения: данные являются достоверными, но отсутствуют для всех бразильцев, которые никогда не получали водительское удостоверение. Нужен более широкий охват? Используйте вместо этого BRA - Unico IDCloud (CPF + selfie). Он охватывает около 96% взрослых бразильцев через частный биометрический реестр Unico и стоит $0.20 против $0.45 здесь. Выбирайте Datavalid, когда вам нужен именно государственный реестр как источник достоверных данных, а IDCloud, когда нужно проверить всех.Продолжить чтение
Последнее изменение 7 ноября 2026 г.