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.
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.
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.