Una sessió cobreix la identitat del sol·licitant, l'adreça actual, la revisió de sancions i el dret a llogar. Cinc minuts al telèfon, paquet signat per al propietari. 500 verificacions gratuïtes cada mes.
Confiat per més de 2.000 organitzacions a tot el món.
El que un agent immobiliari deu
La verificació en paper és lenta, cara i fàcil de falsificar. Didit la substitueix amb una sessió allotjada: ID + liveness + comparació facial + prova d'adreça + AML + comprovació d'elegibilitat per al lloguer, $0.33 per sol·licitant més $0.20 per la prova d'adreça. 500 verificacions gratuïtes cada mes, veredicte en menys de 2 segons.
Tria les comprovacions que vulguis: ID, liveness, comparació facial, sancions, adreça, edat, telèfon, correu electrònic, preguntes personalitzades. Arrossega-les a un flux al panell de control, o publica el mateix flux a la nostra API. Crea ramificacions segons condicions, fes proves A/B, sense necessitat de codi.
$ curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workflow_id": "wf_tenant_screening",
"vendor_data": "applicant-42",
"expected_country": "GB"
}'{ "url": "verify.didit.me/..." }$ curl https://verification.didit.me/v3/session/$SESSION/decision/ \
-H "x-api-key: $DIDIT_API_KEY"
# Decision payload (excerpted):
{ "status": "Approved",
"proof_of_address": { "status": "Approved", "address": { ... } },
"database_validation": { "service": "uk_right_to_rent" } }estat Aprovat · En Revisió · Rebutjat · ReenviatYou are integrating Didit into a residential-leasing platform (PropTech / build-to-rent / letting-agent archetype). You owe the landlord (or your platform owes the landlord) an evidence pack on every applicant before the keys come off the hook.
Four obligations on every application:
1. Verify the applicant's identity — government ID + liveness + face match.
2. Validate the current address — utility, bank, or registry-issued letter, cross-checked against the ID.
3. Confirm lease eligibility — Right to Rent (UK) / state-of-residence (US) / residency document (EU) / national tax id (LatAm).
4. Screen the applicant against sanctions, Politically Exposed Persons (PEP), and adverse-media lists.
Optional: run the same flow against a guarantor and stitch both back to the lease record.
Pricing (verified live):
- Tenant KYC bundle: $0.33 per applicant (ID + Liveness + Face Match + IP + AML)
- Proof of Address: $0.20 per check
- Database Validation (right-to-rent / national id): variable, per-jurisdiction
- Linked guarantor KYC: $0.33 per guarantor
- First 500 KYC verifications free every month, forever
PRE-REQUISITES
- Production API key from https://business.didit.me (sandbox key in 60s, no card).
- Webhook endpoint with HMAC SHA-256 verification using the X-Signature-V2 header and your webhook secret.
- A workflow_id from the Workflow Builder that bundles ID Verification + Passive Liveness + Face Match 1:1 + Proof of Address + AML Screening + the jurisdiction-specific Database Validation node.
- Optional: a separate KYC workflow_id for the guarantor.
STEP 1 — Create the tenant session
POST https://verification.didit.me/v3/session/
Headers:
x-api-key: <your api key>
Content-Type: application/json
Body:
{
"workflow_id": "<your tenant-screening workflow id>",
"vendor_data": "<your applicant id, max 256 chars>",
"callback_url": "https://<your-app>/applications/kyc/callback",
"expected_country": "GB",
"metadata": {
"application_id": "<your internal id>",
"property_id": "<unit reference>"
}
}
Response: 201 Created with the hosted session URL. SMS or email the URL to the applicant; they complete everything on their phone in under five minutes.
STEP 2 — Read the signed webhook on KYC completion
Didit POSTs to your callback. Session statuses are Title Case With Spaces:
Body (excerpted):
{
"session_id": "<uuid>",
"vendor_data": "<your applicant id>",
"status": "Approved",
"id_verification": { "status": "Approved", "document_type": "passport", "country_code": "GB" },
"liveness": { "status": "Approved" },
"face": { "status": "Approved", "similarity_score": 0.94 },
"proof_of_address": { "status": "Approved", "document_type": "utility_bill", "address": { "line1": "10 Long Acre", "city": "London", "postal_code": "WC2E 9LH", "country": "GB" } },
"aml": { "status": "Approved", "hits": [] },
"database_validation": { "status": "Approved", "service": "uk_right_to_rent", "result": { "share_code_status": "valid", "expiry_date": "2027-08-12" } }
}
Session status enum (exact case):
Approved | Declined | In Review | Resubmitted | Expired | Not Finished | Kyc Expired | Abandoned
Verify the X-Signature-V2 header BEFORE reading the body — HMAC SHA-256 of the raw bytes with your webhook secret.
STEP 3 — (Optional) Spawn a guarantor session
If the workflow declares a guarantor step, the parent session returns a guarantor_session_url inside the decision payload. Email it to the guarantor and they run the same KYC flow on their phone. The result threads back to the parent tenant record automatically.
Alternatively, fire a second POST /v3/session/ with a separate guarantor workflow_id and stitch the two together by setting metadata.tenant_session_id on the guarantor call.
STEP 4 — Retrieve the full evidence pack
GET https://verification.didit.me/v3/session/{sessionId}/decision/
Headers:
x-api-key: <your api key>
Returns the full decision payload — ID block, liveness block, face match, proof-of-address result with the canonical address fields, AML hits, database-validation outcome. Use this for audit-pack export and for rendering the applicant status in your letting-agent dashboard.
STEP 5 — Decide
Branch logic:
Approved → forward the pack to the landlord, advance to lease signing.
In Review → hold the application, wait for analyst webhook update.
Declined → refuse the application, log the decline reason.
Resubmitted → applicant updated something; re-read the decision.
For Database Validation specifically — if the result indicates an expired Right to Rent share code, ask the applicant for a fresh one before moving forward.
STEP 6 — Ongoing monitoring (long leases)
For multi-year tenancies, enable Ongoing AML at $0.07/user/year. The session status updates automatically when the tenant lands on a new sanctions list or document expirations approach (passport, visa, residency permit). Your webhook fires on every state change.
No separate endpoint to call — the same workflow drives it.
WEBHOOK EVENT NAMES
- status.updated — session status changed.
- data.updated — session data changed (resubmission, expiry, ongoing AML hit).
Verify X-Signature-V2 on every payload. The webhook secret is per-environment — sandbox key is separate from production.
CONSTRAINTS
- Session statuses use Title Case With Spaces (Approved, In Review).
- Default record retention is 5 years per tenant per the EU AML package; UK Right to Rent requires document copies for the tenancy duration + one year.
- The address on the Proof of Address document MUST match the address on the underlying ID for an Approved outcome; if they differ, the session flips to In Review.
Read the docs:
- https://docs.didit.me/sessions-api/create-session
- https://docs.didit.me/sessions-api/retrieve-session
- https://docs.didit.me/core-technology/proof-of-address/overview
- https://docs.didit.me/core-technology/aml-screening/overview
- https://docs.didit.me/integration/webhooks
Start free at https://business.didit.me — sandbox key in 60 seconds, 500 verifications free every month, no credit card.
Per construir, provar i per als teus primers usuaris.
Més de 25 mòduls amb preus públics. Descomptes automàtics per volum.
Per a grans volums i programes regulats.
Els descomptes per volum s'apliquen automàticament a mesura que augmenta l'ús — sense negociacions ni trucades de vendes.
Didit és la infraestructura per a la identitat i el frau, la plataforma que ens hauria agradat tenir quan creàvem els nostres propis productes: oberta, flexible i pensada per a desenvolupadors, perquè s'integri perfectament al teu "stack" en lloc de ser una caixa negra.
Una sola API cobreix la verificació de persones (KYC, know your customer), la verificació d'empreses (KYB, know your business), el cribratge de carteres de criptomonedes (KYT, know your transaction) i el monitoratge de transaccions en temps real, tot sobre una arquitectura dissenyada per ser:
La base tecnològica inclou: més de 14.000 tipus de documents en més de 48 idiomes, més de 1.000 fonts de dades i més de 200 senyals de frau per sessió. La infraestructura de Didit aprèn dinàmicament de cada sessió i millora cada dia.
És el procés que un propietari o agent immobiliari realitza abans de lliurar les claus, per assegurar-se que el sol·licitant és qui diu ser i pot llogar legalment. Les parts estàndard són:
Didit ho ofereix tot en un sol flux allotjat. El sol·licitant ho completa al seu telèfon en menys de cinc minuts; l'agent rep un paquet signat.
Qualsevol que llogui una propietat residencial a un tercer. A la pràctica, això significa:
Al Regne Unit, les comprovacions de Right to Rent són un requisit legal estricte segons la Llei d'Immigració, amb multes materials per inquilí per no realitzar-les. La UE té obligacions paral·leles segons el paquet AML per a qualsevol professional immobiliari. Els EUA ho gestionen a través de la llei estatal de propietaris i inquilins, a més de les normes d'habitatge just.
El flux complet normalment triga menys de 30 segons de principi a fi: agafar el DNI, fer la foto del document, fer-se el selfie, fet. Això és el més ràpid del mercat. Els proveïdors de KYC antics solen trigar més de 90 segons per al mateix flux.
Al back-end, Didit retorna el resultat en menys de dos segons al p99, mesurat des del moment en què l'usuari acaba el selfie fins al moment en què s'activa el teu webhook. La captura mòbil està optimitzada per a telèfons lents i xarxes lentes: compressió progressiva d'imatges, càrrega lenta del kit de desenvolupament de programari i un traspàs amb un sol toc de l'escriptori al telèfon mitjançant codi QR si l'usuari comença al web.
Tres coses, per ordre de freqüència amb què es produeixen:
La comprovació tradicional en paper és lenta, cara (normalment 15-40 £ per sol·licitant a través de proveïdors antics) i fàcil de falsificar. La majoria d'agents acaben fent una comprovació parcial i esperant el millor. Didit elimina el dilema: cobertura completa per 0,53 $ per sol·licitant (paquet KYC + prova d'adreça).
Cada sessió arriba a un dels set estats clars, de manera que el teu codi sempre sap què fer:
Approved (Aprovat): totes les comprovacions superades. Fes avançar l'usuari.Declined (Rebutjat): una o més comprovacions han fallat. Pots permetre a l'usuari tornar a enviar el pas fallit específic (per exemple, tornar a fer el selfie) sense tornar a executar tot el flux.In Review (En revisió): marcat per a revisió de compliment. Obre el cas a la consola, consulta tots els senyals, decideix aprovar o rebutjar.In Progress (En curs): l'usuari està a mig flux.Not Started (No iniciat): enllaç enviat, l'usuari encara no l'ha obert. Envia un recordatori si passa massa temps.Abandoned (Abandonat): l'usuari va obrir l'enllaç però no va acabar a temps. Torna a contactar o fes que caduqui.Expired (Caducat): l'enllaç de la sessió ha caducat. Crea una nova sessió.Un webhook signat s'activa en cada canvi d'estat, de manera que la teva base de dades sempre es manté sincronitzada. Les sessions abandonades i rebutjades són gratuïtes.
Les dades de producció es processen i s'emmagatzemen a la Unió Europea per defecte, a Amazon Web Services. Els contractes empresarials poden sol·licitar regions alternatives per a jurisdiccions que ho requereixin els seus reguladors.
Xifratge a tot arreu. AES-256 en repòs a totes les bases de dades, emmagatzematge d'objectes i còpies de seguretat. Transport Layer Security 1.3 en trànsit a cada trucada API, webhook i sessió de la Business Console. Les dades biomètriques es xifren amb una Customer Master Key separada.
La retenció la controles tu. La retenció per defecte és indefinida (il·limitada), tret que la configuris més curta, entre 30 dies i 10 anys per aplicació, i pots eliminar qualsevol sessió individual en qualsevol moment des del tauler de control o l'API.
Certificacions: SOC 2 Type 1 & Type 2, ISO/IEC 27001:2022, iBeta Level 1 PAD, i una certificació pública del Tesoro / SEPBLAC / CNMV d'Espanya que la verificació remota d'identitat de Didit és més segura que la verificació presencial. Informe complet a /security-compliance.
Didit compleix per defecte amb els reguladors importants per a la infraestructura d'identitat:
Memo detallat, cada certificat, cada carta del regulador: /security-compliance.
Tres rutes d'integració: tria la que millor s'adapti a la teva pila:
Mateix tauler de control, mateixa facturació, mateix preu de pagament per èxit per als tres. Guia pas a pas a docs.didit.me/integration/integration-prompt.
Es realitzen tres capes de validació en cada càrrega de prova d'adreça:
Patrons de frau que Didit detecta: una factura de serveis retocada amb Photoshop amb una adreça falsificada, una factura real d'un edifici diferent, una factura que pertany a una persona diferent a la mateixa adreça, una factura caducada (més de 90 dies). Les tres capes s'executen al costat del servidor; l'agent mai veu una càrrega bruta, només el resultat validat.
La verificació a l'inici del lloguer és necessària però no suficient: per a lloguers llargs, els inquilins canvien de circumstàncies i les llistes de sancions s'actualitzen diàriament. La monitorització contínua de Didit detecta:
Tot flueix a través del mateix webhook status.updated que vas configurar per a l'onboarding. Sense nous punts finals, sense integració addicional.
La majoria de proveïdors de selecció d'inquilins tenen un preu d'entre 15 i 40 £ per sol·licitant: Goodlord, Letting a Property, eines d'accessibilitat basades en Open Banking. La majoria cobren per comprovació, més una tarifa d'administració per lloguer, més un recàrrec per Right-to-Rent.
El preu publicat de Didit és de 0,33 $ per al paquet KYC + 0,20 $ per a la prova d'adreça = 0,53 $ per sol·licitant. La validació de la base de dades és variable per jurisdicció i normalment afegeix 0,05-0,20 $ depenent del servei. Sense mínims, sense compromís, sense recàrrec per país.
Això és aproximadament 10 vegades més barat que la pila existent amb la mateixa producció legal. En una cartera de construcció per a lloguer de 200 inquilins que es renova un cop a l'any, l'estalvi és d'aproximadament 3.000 £ en costos de selecció, i l'experiència del sol·licitant és més ràpida, sense paper, sense escaneig. Preus complets a /pricing.
Una API per a KYC, KYB, monitorització de transaccions i anàlisi de carteres. Integra-la en 5 minuts.