GET
/users/v2/kyc/{user_id}/flow/{flow_id}Obtener validación KYC
El endpoint GET /users/v2/kyc/{user_id}/flow/{flow_id} devuelve el estado actual de la validación KYC de un usuario, incluyendo los documentos requeridos y los datos personales declarados.
Estados de validación
| Estado | Descripción |
|---|---|
OPEN | Validación creada, esperando carga de documentos |
PENDING_REQUIREMENTS | Esperando que el usuario cargue documentos requeridos o declare datos personales |
REQUIREMENTS_SUBMITTED | Todos los requisitos fueron enviados |
PROCESSING | El proveedor está procesando la solicitud |
IN_REVIEW | En revisión manual |
COMPLETED | Validación finalizada (ver validation_result para el resultado) |
DELETED | Validación cancelada o eliminada |
Resultados de validación
| Resultado | Descripción |
|---|---|
SUCCESS | Identidad verificada exitosamente |
RETRY | El usuario debe reintentar el proceso KYC |
REJECTED | La verificación de identidad fue rechazada |
Parámetros disponibles
Header Parameters
AuthorizationStringrequired
Path Parameters
user_idStringrequired
flow_idStringrequired
Detalle de respuestas
401
No autorizado
Ejemplo de código
curl -X GET "https://api.pomelo.la/users/v2/kyc/example_value/flow/global-cards" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY"Ejemplo de respuesta (200)Validación encontrada
{
"user_id": "usr-203c6jQq0O3nVWXj6jRUQXy7QkC",
"validation_flow": "global-cards",
"external_id": "abc123xyz",
"validation_status": "OPEN",
"validation_result": "",
"required_files": [
{
"category": "IDENTITY",
"status": "PENDING",
"options": [
{
"document_type": "PASSPORT",
"status": "PENDING",
"sides_required": 1,
"files": [
{
"status": "UPLOADED",
"side": "FRONT",
"name": "passport_front.jpg",
"rejection_reasons": [
"DOCUMENT_QUALITY_ISSUE"
]
}
]
}
]
}
],
"declared_personal_data": {
"status": "PENDING",
"data": {}
}
}