Saltar al contingut principal
POST
curl

Suport per a KYC i KYB

Funciona tant per a sessions de Verificació d’usuaris (KYC) com de Verificació d’empreses (KYB). Didit resol el session_id contra els dos tipus de sessió i genera un token de compartició JWT que inclou:
Quan el soci receptor importa el token, Didit clona el tipus de sessió corresponent (KYC o KYB) amb les seves relacions.

Requisits

  • La sessió ha d’estar en un estat finalitzat (APPROVED, DECLINED, IN_REVIEW).
  • Has de tenir el privilegi write:sessions.
  • El for_application_id ha de ser una aplicació vàlida de Didit (normalment l’aplicació d’un soci).

Exemples

Resposta:

Límits del TTL

Relacionat

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'origen per a la qual s'ha d'emetre un token.

Exemple:

"11111111-2222-3333-4444-555555555555"

Cos

application/json
for_application_id
string<uuid>
requerit

UUID de l'aplicació de Didit que bescanviarà el token. Ha d'existir, no pot estar suprimida i ha de ser diferent de l'aplicació que fa la crida. Troba'l a la Business Console a Settings → Application.

Exemple:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

ttl_in_seconds
integer
predeterminat:3600

Temps de vida del token, en segons. Mínim 60, màxim 86400 (24 h). Per defecte és 3600 (1 h).

Rang requerit: 60 <= x <= 86400
Exemple:

3600

Resposta

Token de compartició generat.

share_token
string

JWT signat amb HS256. Passa això literalment com a share_token a POST /v3/session/import-shared/ a l'aplicació de destinació.

Exemple:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

for_application_id
string<uuid>

Retorna el UUID de l'aplicació de destinació a la qual està vinculat el token.

Exemple:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

session_kind
enum<string>

Si la sessió d'origen és una sessió de Verificació d'usuaris (KYC) o de Verificació d'empreses (KYB).

Opcions disponibles:
user,
business
Darrera modificació el 7 de novembre del 2026