Flujo de la API de onboarding de individuos
Utiliza este mapa para conectar la política KYC de individuos con la referencia actual generada de la API. Sigue el recurso actual en cada paso en lugar de implementar las etiquetas de política como una máquina de estados de la API.Mapa del flujo
1. Crea el cliente individual
Crea el cliente conPOST /v3/customers. Guarda el id de cliente devuelto y lee el recurso actual con GET /v3/customers/{customerId}.
2. Descubre y solicita una capacidad elegible
LeeGET /v3/customers/{customerId}/capabilities/supported. Selecciona una variante solo cuando su disponibilidad y elegibilidad actuales permitan la solicitud, y luego utiliza POST /v3/customers/{customerId}/capabilities/{capabilityId}.
3. Lee la capacidad y las aplicaciones actuales
LeeGET /v3/customers/{customerId}/capabilities/{capabilityId} y GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications. Sigue los ids de tarea abiertos actuales en lugar de asumir la disponibilidad a partir de una respuesta anterior.
Para las capacidades bancarias named, un cliente tiene un caso de aplicación por banco, compartido entre las capacidades compatibles. Consulta Aplicaciones compartidas por banco para ver los códigos de respuesta, selectedApplicationId y la lista de aplicaciones del cliente.
4. Obtén el detalle actual de la tarea
Lista las tareas del cliente conGET /v3/customers/{customerId}/tasks. Obtén la superficie de acción autorizada con GET /v3/customers/{customerId}/tasks/{taskId}.
El detalle de la tarea puede exponer URLs de sesiones alojadas de primera parte y los requisitos accionables actuales. Utiliza su revisión y estado actuales.
En las tareas de intake que aceptan el envío directo, los requisitos elegibles que ya están respaldados por el perfil del cliente o por documentos subidos pasan a revisión automáticamente. Construye los formularios a partir de los metadatos de cada requisito. Consulta Renderiza los requisitos.
5. Completa sesiones alojadas o envía respuestas de la tarea
Cuando el detalle de la tarea proporciona una sesión alojada, devuelve solo los datos de sesión necesarios a tu cliente y mantén la clave de la API en tu backend. Cuando la tarea requiere respuestas, crea un intento inmutable completo conPOST /v3/customers/{customerId}/tasks/{taskId}/submissions. Lee un envío actual y su resultado público con GET /v3/customers/{customerId}/tasks/{taskId}/submissions/{submissionId}.
6. Sube documentos solo cuando se soliciten
Sube documentos solo cuando la tarea actual los solicite. UtilizaPOST /v3/customers/{customerId}/documents y luego coloca el id de documento devuelto en la respuesta documental correspondiente.