Saltar al contingut principal
POST
curl
Utilitza-ho quan l’enllaç anterior ja no funciona: la sessió s’ha eliminat o ha caducat abans que la persona l’hagués iniciat. Les sessions eliminades compleixen els requisits encara que la persona ja hagi iniciat o completat la verificació. Les sessions importades no compleixen els requisits per caducitat; cal que s’hagin eliminat. Una sessió que no s’ha eliminat i que la persona ja havia iniciat no compleix els requisits per caducitat. La nova sessió queda vinculada a la mateixa part, de manera que el resultat arriba a la verificació de persones clau igual que ho faria l’original, i el seu enllaç dura el temps de caducitat de la sessió del flux de treball KYC que executa (d’1 hora a 4 setmanes), no el de la sessió empresarial. Llegeix la part i les seves sessions filles a la decisió de la sessió empresarial. Si la persona no s’ha de verificar en absolut, omet la part en lloc d’això. Consulta Persones clau per saber com funcionen les parts i les seves verificacions.

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ó pare de Verificació d'empreses (KYB).

Exemple:

"33333333-4444-5555-6666-777777777777"

partyUuid
string<uuid>
requerit

UUID de la part de Persones clau (key_people_checks[].submitted.parties[].uuid a la decisió de la sessió d'empresa). Ha de pertànyer a la sessió a la qual fa referència sessionId.

Exemple:

"0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41"

Resposta

S'ha creat una nova sessió de KYC. Retorna l'entitat actualitzada amb la seva nova sessió filla, que caduca després del temps de caducitat de la sessió del seu flux de treball de KYC.

Una part de persones clau d'una sessió de Verificació d'empreses (KYB), amb la seva verificació dependent. La mateixa part apareix a key_people_checks[].submitted.parties[] de la decisió de la sessió d'empresa.

uuid
string<uuid>
requerit

Identificador de la part.

entity_type
enum<string>
requerit

Si la part és una persona física o una empresa.

Opcions disponibles:
person,
company
source
enum<string>
requerit

REGISTRY: obtingut del registre mercantil. USER: introduït a la pantalla Persones clau.

Opcions disponibles:
REGISTRY,
USER
name
string
requerit

Nom visible de la part.

is_active
boolean
requerit

Si la part està activa.

is_skipped
boolean
requerit

Si la part està exempta de verificació. En regenerar-la, s'esborra.

requires_verification
boolean
requerit

Si les regles de rol i titularitat requereixen una verificació per a aquesta part.

roles
object[]
requerit

Rols que té la part a l'empresa.

kyc_session_deleted
boolean
requerit

La sessió fill de KYC s'ha suprimit, de manera que no es podrà liquidar mai.

kyb_sub_session_deleted
boolean
requerit

Homòleg per a empreses de kyc_session_deleted.

first_name
string | null

Nom de pila (persones).

last_name
string | null

Cognom (persones físiques).

company_name
string | null

Nom de l'empresa (parts empresarials).

registration_number
string | null

Número de registre de l'empresa (parts empresarials).

email
string<email> | null

Correu electrònic al qual s'envia l'enllaç de verificació.

nationality
string | null

Nacionalitat per a persones, país de constitució per a empreses.

phone_number
string | null

Número de telèfon recollit per a la part.

date_of_birth
string<date> | null

Data de naixement (persones).

position
string | null

Càrrec de text lliure (per a persones).

custom_fields
object

Camps personalitzats definits pel flux de treball i recollits per a la part, indexats per clau de camp.

kyc_session_id
string<uuid> | null

Sessió KYC individual filla (persones físiques).

kyc_session_status
enum<string> | null

Estat de la sessió KYC filla. Una sessió eliminada manté l'estat que tenia quan es va eliminar.

Opcions disponibles:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyc_session_url
string<uri> | null

Enllaç allotjat de la sessió de KYC filla. null quan no n'hi ha cap o s'ha suprimit, i per a una clau d'API amb àmbit restringit sense sessions: write.

kyb_sub_session_id
string<uuid> | null

Sessió KYB filla (parts d'empresa).

kyb_sub_session_status
enum<string> | null

Estat de la sessió KYB filla.

Opcions disponibles:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyb_sub_session_url
string<uri> | null

Enllaç allotjat de la sessió de KYB filla, amb les mateixes regles de null que kyc_session_url.

verification_workflow_type
enum<string> | null

Tipus del flux de treball que executa la sessió filla.

Opcions disponibles:
kyc,
kyb,
adaptive_age_verification,
biometric_authentication,
address_verification,
questionnaire_verification,
email_verification,
phone_verification,
null
verification_workflow_id
string<uuid> | null

Flux de treball que executa la sessió filla.

verification_workflow_label
string | null

Etiqueta d'aquest flux de treball.

verification_workflow_features
object[] | null

Funcionalitats del flux de treball de la sessió filla amb els seus estats actuals.

didit_internal_id
string<uuid> | null

Identificador de Didit de la persona verificada, un cop conegut.

Darrera modificació el 7 de novembre del 2026