Primeros pasos
Integración / SDKs
Verificación de usuarios
Verificación de empresas
Monitorización de transacciones
Registro de cambioscurl -X POST 'https://verification.didit.me/v3/poa/' \
-H 'x-api-key: YOUR_API_KEY' \
-F 'document=@./utility-bill.pdf' \
-F 'expected_address=Av. Monseñor Tavella 1291, Salta, Argentina' \
-F 'expected_country=ARG' \
-F 'expected_first_name=Sophia' \
-F 'expected_last_name=Martinez' \
-F 'poa_languages_allowed=en,es' \
-F 'vendor_data=user-123' \
--max-time 45from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.proof_of_address.verify(
document=open("document.pdf", "rb"),
expected_address="Av. Monseñor Tavella 1291, Salta, Argentina",
expected_country="ARG",
expected_first_name="Sophia",
expected_last_name="Martinez",
poa_languages_allowed="en,es",
save_api_request=True,
vendor_data="user-123",
)
print(result)import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.proofOfAddress.verify({
document: await fileFromPath("document.pdf"),
expected_address: "Av. Monseñor Tavella 1291, Salta, Argentina",
expected_country: "ARG",
expected_first_name: "Sophia",
expected_last_name: "Martinez",
poa_languages_allowed: "en,es",
save_api_request: true,
vendor_data: "user-123",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.ProofOfAddress.Verify(ctx, didit.ProofOfAddressVerifyParams{
Document: didit.FileFromPath("document.pdf"),
ExpectedAddress: didit.String("Av. Monseñor Tavella 1291, Salta, Argentina"),
ExpectedCountry: didit.String("ARG"),
ExpectedFirstName: didit.String("Sophia"),
ExpectedLastName: didit.String("Martinez"),
POALanguagesAllowed: didit.String("en,es"),
SaveAPIRequest: didit.Bool(true),
VendorData: didit.String("user-123"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.nio.file.Path;
import me.didit.Didit;
import me.didit.types.ProofOfAddressVerifyParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.proofOfAddress().verify(ProofOfAddressVerifyParams.builder()
.document(Path.of("document.pdf"))
.expectedAddress("Av. Monseñor Tavella 1291, Salta, Argentina")
.expectedCountry("ARG")
.expectedFirstName("Sophia")
.expectedLastName("Martinez")
.poaLanguagesAllowed("en,es")
.saveApiRequest(true)
.vendorData("user-123")
.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->proofOfAddress->verify([
'document' => File::fromPath('document.pdf'),
'expected_address' => 'Av. Monseñor Tavella 1291, Salta, Argentina',
'expected_country' => 'ARG',
'expected_first_name' => 'Sophia',
'expected_last_name' => 'Martinez',
'poa_languages_allowed' => 'en,es',
'save_api_request' => true,
'vendor_data' => 'user-123',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.proof_of_address.verify(
document: Pathname("document.pdf"),
expected_address: "Av. Monseñor Tavella 1291, Salta, Argentina",
expected_country: "ARG",
expected_first_name: "Sophia",
expected_last_name: "Martinez",
poa_languages_allowed: "en,es",
save_api_request: true,
vendor_data: "user-123"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.ProofOfAddress.VerifyAsync(new ProofOfAddressVerifyParams
{
Document = FileUpload.FromPath("document.pdf"),
ExpectedAddress = "Av. Monseñor Tavella 1291, Salta, Argentina",
ExpectedCountry = "ARG",
ExpectedFirstName = "Sophia",
ExpectedLastName = "Martinez",
PoaLanguagesAllowed = "en,es",
SaveApiRequest = true,
VendorData = "user-123",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"request_id": "4b523a8d-ed32-45e4-8aa8-a89eda459d88",
"poa": {
"issuing_state": "ARG",
"document_type": "UTILITY_BILL",
"document_subtype": "WATER_BILL",
"document_language": "es",
"issuer": "Aguas del Norte",
"issue_date": "2026-04-10",
"expiration_date": null,
"poa_address": "AVDA. MONSEÑOR TAVELLA N° 1291, B° VILLA LAVALLE CP: 4400, CAPITAL - SALTA",
"poa_formatted_address": "Av. Monseñor Tavella 1291 b, A4400 Salta, Argentina",
"poa_parsed_address": {
"street_1": "Avenida Monseñor Tavella 1291",
"street_2": "b",
"city": "Salta",
"region": "Salta",
"country": "AR",
"postal_code": "A4400",
"document_location": {
"latitude": -24.8208682,
"longitude": -65.4130954
}
},
"expected_details_address": null,
"expected_details_formatted_address": null,
"expected_details_parsed_address": null,
"name_on_document": "OESTE EMBOTELLADORA S.A.",
"extra_fields": {
"bank_account_number": null,
"bank_iban": null,
"bank_sort_code": null,
"bank_routing_number": null,
"bank_swift_bic": null,
"bank_branch_name": null,
"bank_branch_address": null,
"document_phone_number": null,
"additional_names": [
"LA EMBOTELLADORA DEL NORTE SA"
]
},
"detected_codes": [
{
"type": "QR_CODE",
"page_number": 1,
"position": [
[
820,
1120
],
[
1002,
1120
],
[
1002,
1302
],
[
820,
1302
]
],
"x": 820,
"y": 1120,
"width": 182,
"height": 182,
"page_width": 1190,
"page_height": 1684,
"raw_payload": "aHR0cHM6Ly9hZ3Vhc2RlbG5vcnRlLmNvbS9mYWN0dXJhLzk5ODgxMQ==",
"parsed_payload": "https://aguasdelnorte.com/factura/998811"
},
{
"type": "CODE_128",
"page_number": 1,
"position": [
[
112,
1480
],
[
560,
1480
],
[
560,
1540
],
[
112,
1540
]
],
"x": 112,
"y": 1480,
"width": 448,
"height": 60,
"page_width": 1190,
"page_height": 1684,
"raw_payload": "MDA5OTg4MTEwMDA0Mg==",
"parsed_payload": "0099881100042"
}
],
"status": "Approved",
"warnings": []
},
"vendor_data": "user-123",
"metadata": null,
"created_at": "2026-06-12T02:29:02.439655+00:00"
}API de comprobante de domicilio: verificación POA y OCR
POST /v3/poa/ de Didit verifica facturas, extractos bancarios y alquileres: OCR de dirección, autenticidad y pago por uso sin contratos.
curl -X POST 'https://verification.didit.me/v3/poa/' \
-H 'x-api-key: YOUR_API_KEY' \
-F 'document=@./utility-bill.pdf' \
-F 'expected_address=Av. Monseñor Tavella 1291, Salta, Argentina' \
-F 'expected_country=ARG' \
-F 'expected_first_name=Sophia' \
-F 'expected_last_name=Martinez' \
-F 'poa_languages_allowed=en,es' \
-F 'vendor_data=user-123' \
--max-time 45from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.proof_of_address.verify(
document=open("document.pdf", "rb"),
expected_address="Av. Monseñor Tavella 1291, Salta, Argentina",
expected_country="ARG",
expected_first_name="Sophia",
expected_last_name="Martinez",
poa_languages_allowed="en,es",
save_api_request=True,
vendor_data="user-123",
)
print(result)import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.proofOfAddress.verify({
document: await fileFromPath("document.pdf"),
expected_address: "Av. Monseñor Tavella 1291, Salta, Argentina",
expected_country: "ARG",
expected_first_name: "Sophia",
expected_last_name: "Martinez",
poa_languages_allowed: "en,es",
save_api_request: true,
vendor_data: "user-123",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.ProofOfAddress.Verify(ctx, didit.ProofOfAddressVerifyParams{
Document: didit.FileFromPath("document.pdf"),
ExpectedAddress: didit.String("Av. Monseñor Tavella 1291, Salta, Argentina"),
ExpectedCountry: didit.String("ARG"),
ExpectedFirstName: didit.String("Sophia"),
ExpectedLastName: didit.String("Martinez"),
POALanguagesAllowed: didit.String("en,es"),
SaveAPIRequest: didit.Bool(true),
VendorData: didit.String("user-123"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.nio.file.Path;
import me.didit.Didit;
import me.didit.types.ProofOfAddressVerifyParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.proofOfAddress().verify(ProofOfAddressVerifyParams.builder()
.document(Path.of("document.pdf"))
.expectedAddress("Av. Monseñor Tavella 1291, Salta, Argentina")
.expectedCountry("ARG")
.expectedFirstName("Sophia")
.expectedLastName("Martinez")
.poaLanguagesAllowed("en,es")
.saveApiRequest(true)
.vendorData("user-123")
.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->proofOfAddress->verify([
'document' => File::fromPath('document.pdf'),
'expected_address' => 'Av. Monseñor Tavella 1291, Salta, Argentina',
'expected_country' => 'ARG',
'expected_first_name' => 'Sophia',
'expected_last_name' => 'Martinez',
'poa_languages_allowed' => 'en,es',
'save_api_request' => true,
'vendor_data' => 'user-123',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.proof_of_address.verify(
document: Pathname("document.pdf"),
expected_address: "Av. Monseñor Tavella 1291, Salta, Argentina",
expected_country: "ARG",
expected_first_name: "Sophia",
expected_last_name: "Martinez",
poa_languages_allowed: "en,es",
save_api_request: true,
vendor_data: "user-123"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.ProofOfAddress.VerifyAsync(new ProofOfAddressVerifyParams
{
Document = FileUpload.FromPath("document.pdf"),
ExpectedAddress = "Av. Monseñor Tavella 1291, Salta, Argentina",
ExpectedCountry = "ARG",
ExpectedFirstName = "Sophia",
ExpectedLastName = "Martinez",
PoaLanguagesAllowed = "en,es",
SaveApiRequest = true,
VendorData = "user-123",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"request_id": "4b523a8d-ed32-45e4-8aa8-a89eda459d88",
"poa": {
"issuing_state": "ARG",
"document_type": "UTILITY_BILL",
"document_subtype": "WATER_BILL",
"document_language": "es",
"issuer": "Aguas del Norte",
"issue_date": "2026-04-10",
"expiration_date": null,
"poa_address": "AVDA. MONSEÑOR TAVELLA N° 1291, B° VILLA LAVALLE CP: 4400, CAPITAL - SALTA",
"poa_formatted_address": "Av. Monseñor Tavella 1291 b, A4400 Salta, Argentina",
"poa_parsed_address": {
"street_1": "Avenida Monseñor Tavella 1291",
"street_2": "b",
"city": "Salta",
"region": "Salta",
"country": "AR",
"postal_code": "A4400",
"document_location": {
"latitude": -24.8208682,
"longitude": -65.4130954
}
},
"expected_details_address": null,
"expected_details_formatted_address": null,
"expected_details_parsed_address": null,
"name_on_document": "OESTE EMBOTELLADORA S.A.",
"extra_fields": {
"bank_account_number": null,
"bank_iban": null,
"bank_sort_code": null,
"bank_routing_number": null,
"bank_swift_bic": null,
"bank_branch_name": null,
"bank_branch_address": null,
"document_phone_number": null,
"additional_names": [
"LA EMBOTELLADORA DEL NORTE SA"
]
},
"detected_codes": [
{
"type": "QR_CODE",
"page_number": 1,
"position": [
[
820,
1120
],
[
1002,
1120
],
[
1002,
1302
],
[
820,
1302
]
],
"x": 820,
"y": 1120,
"width": 182,
"height": 182,
"page_width": 1190,
"page_height": 1684,
"raw_payload": "aHR0cHM6Ly9hZ3Vhc2RlbG5vcnRlLmNvbS9mYWN0dXJhLzk5ODgxMQ==",
"parsed_payload": "https://aguasdelnorte.com/factura/998811"
},
{
"type": "CODE_128",
"page_number": 1,
"position": [
[
112,
1480
],
[
560,
1480
],
[
560,
1540
],
[
112,
1540
]
],
"x": 112,
"y": 1480,
"width": 448,
"height": 60,
"page_width": 1190,
"page_height": 1684,
"raw_payload": "MDA5OTg4MTEwMDA0Mg==",
"parsed_payload": "0099881100042"
}
],
"status": "Approved",
"warnings": []
},
"vendor_data": "user-123",
"metadata": null,
"created_at": "2026-06-12T02:29:02.439655+00:00"
}Autorizaciones
La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.
Cuerpo
El documento de prueba de domicilio. Extensiones permitidas: tiff, jpg, jpeg, png, pdf, webp. Tamaño máximo de carga: 15 MB (los archivos más grandes se rechazan con 400). Se admiten PDF de varias páginas (la latencia es mayor); los PDF cifrados requieren document_password. Las imágenes se comprimen automáticamente antes de procesarlas.
Contraseña para descifrar document cuando es un PDF cifrado. Enviar un PDF cifrado sin contraseña (o con una incorrecta) devuelve 400.
Dirección que se verifica frente al documento. Se geocodifica y se compara con la dirección extraída; una discrepancia (o una dirección esperada que no se puede geocodificar o verificar) añade ADDRESS_MISMATCH_WITH_PROVIDED, que se rige por poa_address_mismatch_action. La forma geocodificada se devuelve en expected_details_formatted_address / expected_details_parsed_address.
"Av. Monseñor Tavella 1291, Salta, Argentina"
País que se verifica contra el documento (código ISO 3166-1, p. ej., ARG o AR). Si no coincide con el país del documento, se añade POA_COUNTRY_MISMATCH_WITH_PROVIDED, que se rige por poa_address_mismatch_action.
"ARG"
Nombre que se verifica contra name_on_document (coincidencia aproximada, con soporte de transliteración). Una puntuación inferior al umbral de coincidencia añade NAME_MISMATCH_WITH_PROVIDED, que se rige por poa_address_mismatch_action.
"Sophia"
Apellido que se verifica contra name_on_document, combinado con expected_first_name para la puntuación de coincidencia.
"Martinez"
Lista separada por comas de los idiomas de documento aceptados, como códigos ISO 639-1 (por ejemplo, en,es,fr). Si se omite o se deja en blanco, se aceptan los 51 idiomas admitidos. Un documento en un idioma que no está en la lista añade UNSUPPORTED_DOCUMENT_LANGUAGE (regulado por poa_unsupported_language_action); un código desconocido en la lista devuelve 400 con el conjunto completo de códigos admitidos.
"en,es"
Pares key:value separados por comas que fijan la antigüedad máxima del documento en meses por tipo de documento. Claves: utility_bill, bank_statement, government_issued_document, other_poa_document; valores: 1–120, o -1 para sin límite (sin comprobación de antigüedad). Valores predeterminados si se omite: utility_bill:3,bank_statement:3,government_issued_document:12,other_poa_document:12. Un documento con más antigüedad que su límite se rechaza con POA_DOCUMENT_EXPIRED. Precaución: cuando proporcionas este campo, indica todos los tipos que aceptas; los tipos omitidos se consideran no aceptados (POA_DOCUMENT_NOT_SUPPORTED_FOR_APPLICATION, informativo) y se omite su comprobación de antigüedad.
"utility_bill:3,bank_statement:6"
Se acepta, pero actualmente no se aplica: las advertencias de discrepancia de nombre (NAME_MISMATCH_WITH_PROVIDED) siguen poa_address_mismatch_action. Configura poa_address_mismatch_action para controlar el comportamiento ante discrepancias tanto de nombre como de dirección.
DECLINE, NO_ACTION Qué hacer ante problemas de integridad del archivo; en la práctica, este endpoint solo genera DOCUMENT_METADATA_MISMATCH.
DECLINE, NO_ACTION Qué hacer cuando se sospecha una manipulación del documento (SUSPECTED_DOCUMENT_MANIPULATION); por ejemplo, el PDF se modificó después de la firma digital, se procesó con un editor de PDF conocido, muestra manipulación con texto superpuesto o tiene fechas EXIF incoherentes.
DECLINE, NO_ACTION Qué hacer cuando el idioma del documento no está en poa_languages_allowed (UNSUPPORTED_DOCUMENT_LANGUAGE).
DECLINE, NO_ACTION Qué hacer cuando los datos extraídos no coinciden con los campos expected_*: ADDRESS_MISMATCH_WITH_PROVIDED, NAME_MISMATCH_WITH_PROVIDED y POA_COUNTRY_MISMATCH_WITH_PROVIDED siguen todos esta acción.
DECLINE, NO_ACTION Qué hacer cuando no se puede identificar ninguna empresa u organización emisora en el documento (ISSUER_NOT_IDENTIFIED).
DECLINE, NO_ACTION Cuando es true (valor predeterminado), guarda la llamada como una sesión de tipo API: visible en la Business Console, recuperable mediante GET /v3/session/{sessionId}/decision/ con el request_id devuelto, notificada mediante un webhook status.updated y con el documento subido almacenado. Cuando es false, no se almacena nada y request_id es un UUID temporal que solo sirve para correlacionar la respuesta.
true
Cadena opaca opcional (tu ID de usuario interno, correo electrónico, UUID…) que se guarda en la sesión persistida y se devuelve en la respuesta. Úsala para relacionar las llamadas a la API con tus propios registros y para filtrar sesiones más adelante.
"user-123"
Objeto JSON opcional que se almacena con la sesión (cuando save_api_request=true) y se devuelve en la respuesta. En solicitudes multipart, envíalo como un campo de cadena codificado en JSON (p. ej., metadata={"flow":"onboarding"}): se convierte en un objeto.
{ "flow": "onboarding" }
Respuesta
Documento procesado. poa.status es Approved o Declined; cada problema detectado se detalla en poa.warnings. Un documento expirado, que no coincide o sospechoso también devuelve 200 con status: "Declined": revisa el cuerpo, no solo el código HTTP. Cuando save_api_request=true, request_id es el ID de la sesión guardada.
ID de la sesión guardada cuando save_api_request=true (se puede usar con GET /v3/session/{sessionId}/decision/); en caso contrario, un UUID de correlación temporal.
Show child attributes
Show child attributes
Devuelve el vendor_data que enviaste, o null.
Devuelve el objeto metadata que enviaste, o null.
Marca de tiempo ISO 8601 (UTC) del momento en que se generó la respuesta.