Saltar al contingut principal
GET
cURL

Suport per a KYC i KYB

Funciona tant per a sessions de Verificació d’usuaris (KYC) com de Verificació d’empreses (KYB). Didit selecciona automàticament la plantilla de PDF adequada:
  • Sessió de Verificació d’usuaris (KYC): informe amb les seccions de verificació d’identitat, prova de vida, coincidència facial, AML i comprovant de domicili.
  • Sessió de Verificació d’empreses (KYB): informe amb les seccions de registre mercantil, persones clau (UBOs i directius), documents, AML, qüestionari, telèfon, correu electrònic i anàlisi d’IP, quan aquestes funcionalitats formen part del flux de treball.
Tots dos utilitzen el mateix procés de generació de PDF i admeten la personalització amb marca blanca (logotip i URL de la política de privadesa).

Convenció de noms de fitxer

Es retorna mitjançant la capçalera Content-Disposition: attachment; filename=....

Requisit d’estat

La sessió ha d’estar en APPROVED, DECLINED o IN_REVIEW per generar un PDF. Les sessions en curs o no iniciades retornen 403.

Exemples

Marca blanca

Quan l’aplicació té activada la personalització amb marca blanca, el PDF utilitza el teu logotip i la URL de la política de privadesa. Configura-ho a Console → Customization.

Permís

Requereix read:sessions. El mateix àmbit per als dos tipus.

Relacionats

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de ruta

sessionId
string<uuid>
requerit

UUID de la sessió de Verificació d'usuaris (KYC) o de Verificació d'empreses (KYB) que cal renderitzar: el session_id retornat per POST /v3/session/. La mateixa ruta funciona per a tots dos tipus de sessió; fes servir el nom de fitxer de Content-Disposition a la resposta per saber quin tipus d'informe has rebut.

Ha de ser un UUID en minúscules i ben format. La ruta només coincideix amb UUID vàlids, de manera que el router d'URL rebutja qualsevol valor mal format abans que s'executi el codi de l'aplicació i la resposta és una pàgina HTML 404 en comptes de l'embolcall JSON {"detail": ...} que es mostra a continuació. El convertidor d'UUID de la ruta només coincideix amb la forma canònica en minúscules; els UUID en hexadecimals en majúscules es rebutgen amb l'HTML 404.

Exemple:

"11111111-2222-3333-4444-555555555555"

Resposta

El document PDF renderitzat, retornat directament com a binari application/pdf: no hi ha cap contenidor JSON ni cap redirecció d'URL de descàrrega. El cos comença amb els bytes màgics %PDF (PDF 1.7). Guarda'l en un fitxer .pdf o transmet-lo directament a qui fa la crida.

The response is of type file.

Darrera modificació el 7 de novembre del 2026