Importar sessió compartida: API de KYC reutilitzable

Llista de funcionalitats de verificació configurades per a aquesta sessió, com a noms visibles: ID_VERIFICATION, NFC, LIVENESS, FACE_MATCH, POA, PHONE, EMAIL_VERIFICATION, AML, IP_ANALYSIS, DATABASE_VALIDATION, QUESTIONNAIRE, AGE_ESTIMATION, FACE_SEARCH, GEOLOCATION (verificació d'ubicació) (les sessions de Verificació d'empreses utilitzen el conjunt de funcionalitats de KYB: KYB_REGISTRY, KYB_DOCUMENTS, KYB_KEY_PEOPLE, AML, PHONE, EMAIL_VERIFICATION, IP_ANALYSIS, QUESTIONNAIRE). Amb include=events cada entrada es converteix en un objecte {feature, node_id} en comptes d'una cadena simple, i la funcionalitat de correu electrònic es reanomena: apareix com a EMAIL en mode d'esdeveniments en lloc del EMAIL_VERIFICATION utilitzat aquí.

Matriu d'informes de verificació d'identitat (OCR) generats per passos de document d'identitat al graf del flux de treball. Sempre és una matriu JSON — llegeix id_verifications[0] i itera si el teu flux de treball pot executar més d'una comprovació d'identitat (per exemple, una comprovació principal més un pas d'escalada). null fins que almenys un pas d'identitat hagi generat dades. Cada element és l'informe complet, incloent-hi node_id, l'status a nivell de funcionalitat, camps del document extrets, URL de les imatges, puntuacions de qualitat, MRZ, anàlisi de l'adreça, coincidències entre sessions i warnings[].

Matriu d'informes d'NFC / ePassport generats per passos d'NFC al graf del flux de treball. Això és sempre una matriu JSON, mai un objecte nfc singular — llegeix nfc_verifications[0] i itera si el teu flux de treball pot executar NFC més d'una vegada. null fins que almenys un pas d'NFC hagi generat dades. Cada element és l'informe complet, incloent-hi node_id, l'status a nivell de funcionalitat, chip_protocol, chip_data, authenticity (integritat de SOD + DG), certificate_summary i warnings[]. Una My Number Card del Japó es llegeix mitjançant JPKI en lloc d'ICAO 9303: el seu element té chip_protocol: "jpki", inclou les seves proves sota jpki i deixa els camps ICAO com a null. Quan el pas d'NFC s'ha omès abans que es pogués arribar a oferir (document sense xip, certificat absent, cap capacitat NFC reportada, clau MRZ il·legible, JPKI no disponible per a una My Number Card), aquest valor roman com a null i nfc_skip_reason n'explica el motiu; una omissió en el pas mateix (l'usuari ha premut ometre, o el lector no estava disponible en el moment de l'escaneig) continua generant un informe amb is_nfc_skipped: true.

Matriu d'informes de prova de vida generats per passos de prova de vida al graf del flux de treball. Sempre és una matriu JSON — mai un objecte liveness singular. null fins que almenys un pas de prova de vida hagi generat dades. Cada element és l'informe complet, incloent-hi node_id, l'status a nivell de funcionalitat, method, score, reference_image, video_url, age_estimation opcional, matches[] entre sessions i warnings[].

Matriu d'informes de coincidència facial generats per passos de coincidència facial al graf del flux de treball. Sempre és una matriu JSON — mai un objecte face_match singular. null fins que almenys un pas de coincidència facial hagi generat dades. Cada element és l'informe complet, incloent-hi node_id, l'status a nivell de funcionalitat, l'score de similitud, source_image, target_image i warnings[].

Matriu d'informes de verificació de telèfon — sempre és una matriu JSON, mai un objecte phone singular. null fins que almenys un pas de telèfon hagi generat dades. Cada element és l'informe complet, incloent-hi node_id, l'status a nivell de funcionalitat, el número de telèfon i metadades del país, lifecycle[], matches[] i warnings[].

Matriu d'informes de verificació de correu electrònic — sempre és una matriu JSON, mai un objecte email singular. null fins que almenys un pas de correu electrònic hagi generat dades. Cada element és l'informe complet, incloent-hi node_id, l'status a nivell de funcionalitat, l'adreça de correu electrònic, dades de filtracions, lifecycle[], matches[] i warnings[].

Matriu d'informes de Comprovant de domicili (POA) — sempre és una matriu JSON, mai un objecte poa singular. null fins que almenys un pas de POA hagi generat dades. Cada element és l'informe complet, incloent-hi node_id, l'status a nivell de funcionalitat, l'URL del fitxer del document, l'emissor, les dates, l'adreça analitzada i warnings[].

Informes de Document AI agrupats per node del flux de treball — sempre una matriu JSON, mai un objecte singular. null fins que almenys un pas de Document AI hagi generat dades. Present només quan session_kind = user. Cada element és un grup de nodes amb un status agregat, el node_id, una matriu items[] dels resultats per document (dades extretes indexades per la clau de camp configurada) i warnings.

Matriu d'informes de respostes de qüestionaris — sempre és una matriu JSON, mai un objecte questionnaire singular. null fins que almenys un pas de qüestionari hagi generat dades. Cada element és l'informe complet, incloent-hi node_id, les metadades del qüestionari, seccions amb elements de formulari i les respostes de l'usuari.

Resultats de la Verificació bancària, un element per pas de Verificació bancària, per a Verificació d'usuaris i d'empreses. null fins que un pas en produeixi un. El camp method de cada element indica com s'ha verificat el compte: open_banking (inici de sessió bancari) o account_lookup (comprovació de compte), o bé un mètode alternatiu statement o microdeposits, i none quan la persona ha continuat sense banc abans que s'avalués cap intent (continued_without_bank). Consulta Mètodes de verificació bancària.

Resultats de la signatura electrònica, un element per signant i pas de signatura, per a Verificació d'usuaris i Verificació d'empreses (KYB). Només és present quan el flux de treball té un pas de Signatura electrònica; una matriu buida fins que un signant hi arriba. Consulta l'Informe de signatura electrònica.

Array d'informes de cribratge AML — sempre és un array JSON, mai un objecte aml singular. null fins que almenys un pas d'AML hagi produït dades. Cada element és l'informe complet, incloent-hi node_id, status a nivell de funcionalitat, total_hits, entity_type, hits[], score, screened_data, is_ongoing_monitoring_enabled i warnings[].

Matriu d'informes d'Anàlisi de dispositiu i IP — sempre és una matriu JSON, mai un objecte ip_analysis singular. null fins que almenys un pas d'anàlisi d'IP hagi generat dades. Cada element és l'informe complet, incloent-hi node_id, l'status a nivell de funcionalitat, dades d'IP i geolocalització, empremta digital del dispositiu i warnings[]. Les entrades amb (node_id, ip_address, device_fingerprint) duplicats es dedupliquen al servidor.

Matriu de resultats de verificació d'ubicació, un per cada pas de verificació d'ubicació: l'intent acceptat d'aquest pas. null fins que un pas de verificació d'ubicació hagi generat dades. Els intents anteriors del mateix pas es troben a geolocation_attempts.

Tots els intents de cada pas de verificació d'ubicació d'aquesta sessió, del més antic al més recent. Els intents substituïts per un reenviament s'ometen. Un flux de treball que retingui geolocation_checks mitjançant els seus atributs de resposta també reté aquesta llista.

Array d'informes de Validació en bases de dades — sempre és un array JSON, mai un objecte database_validation singular. null fins que almenys un pas de validació en bases de dades hagi generat dades. Cada element és l'informe complet, incloent-hi node_id, el status a nivell de funcionalitat, screened_data, les validations[] per servei (cadascuna amb el seu source_data del registre) i warnings[]. Els camps screened_data i source_data varien segons el país:

ARG (Argentina): screened_data: {document_number, selfie, gender, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, date_of_death, tax_id, tax_id_type, face_match_score, sit_1_since, banks, last_position, highest_position, rejected_checks}. Utilitza la validació biomètrica de coincidència facial del RENAPER. El gènere s'infereix automàticament a partir de l'anàlisi facial o del nom de pila quan no està present al document (p. ex., permisos de conduir)

BOL (Bolívia): screened_data: {document_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, gender}

BRA (Brasil): screened_data: {tax_number, first_name, last_name, date_of_birth}. source_data sempre inclou {identification_number, first_name, last_name, date_of_birth, lgpd_minor, minor_under_18, minor_under_16} per a coincidències satisfactòries de CPF. Les consultes d'adults satisfactòries estableixen aquests indicadors a false. El servei Consulta CPF de la Receita Federal pot retornar HTTP 422 (menor de 18 anys) o 451 (menor de 16 anys) amb dades retingudes per la LGPD; en aquests casos, source_data estableix els indicadors de menor a true segons correspongui, inclou l'estat HTTP del servei d'origen i la validació a nivell de camp és no_match. Consulta la secció del Brasil de la referència de Codis de resultats de la validació en bases de dades per obtenir la llista completa de codis.

CHL (Xile): screened_data: {personal_number, first_name, last_name, date_of_birth}. source_data: {identification_number, first_name, last_name, date_of_birth, gender}

COL (Colòmbia): screened_data: {document_number, document_type, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, document_type}

CRI (Costa Rica): screened_data: {personal_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

DOM (República Dominicana): screened_data: {personal_number}. source_data: {identification_number} (només retorna vàlid/invàlid)

ECU (Equador): screened_data: {personal_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, street, formatted_address, gender, nationality, education, marital_status, spouse, mother_name, father_name, profession}

ESP (Espanya): screened_data: {personal_number, document_type, expiration_date, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, document_type, expiration_date}

GTM (Guatemala): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

HND (Hondures): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

MEX (Mèxic): screened_data: {personal_number (CURP), first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, gender, nationality, curp_status, state_of_birth, doc_probatorio, registration_year, registration_state, registration_municipality, num_acta, crip, issuing_state_code, foreign_registry_number, folio_carta, folio_certificado}. Utilitza el registre civil RENAPO. També hi ha disponible un servei independent de verificació de validesa de l'INE per a MEX com a validació addicional individual.

PAN (Panamà): screened_data: {personal_number, selfie}. source_data: {identification_number}. Utilitza la validació biomètrica del SIB

PER (Perú): screened_data: {personal_number (DNI), first_name, last_name}. source_data: {identification_number, first_name, last_name, paternal_name, maternal_name, verification_number, verification_letter}

PRY (Paraguai): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

SLV (El Salvador): screened_data: {document_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

URY (Uruguai): screened_data: {personal_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

VEN (Veneçuela): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, gender, date_of_birth, document_type}

Comprovacions del registre mercantil. Només present quan session_kind = business. Cada element conté el payload complet del registre mercantil.

Comprovacions agregades de persones clau. Present només quan session_kind = business. Cada element utilitza l'estructura de dos blocs (registry, submitted, ubo_kyc_summary).

Comprovacions de verificació de documents agrupades per node del flux de treball. Només presents quan session_kind = business.

Retornat només amb include=resubmissions, per a sessions d'usuari i d'empresa. Una entrada per sol·licitud de reenviament, començant per la més antiga. Cada entrada conté els resultats que els passos tornats a enviar van retornar abans de la sol·licitud, de manera que les trameses anteriors es mantenen consultables. Si s'elimina la sessió, s'eliminen totes les trameses.