POST
/users/v2/kyc/{user_id}/flow/{flow_id}Crear validación KYC
El endpoint POST /users/v2/kyc/{user_id}/flow/{flow_id} inicia una nueva validación KYC para el usuario bajo el flujo especificado.
Consideraciones
Si ya existe una validación abierta para el mismo usuario y flujo, se devolverá un error VALIDATION_ALREADY_EXISTS.
Parámetros disponibles
Header Parameters
AuthorizationStringrequired
Path Parameters
user_idStringrequired
flow_idStringrequired
Detalle de respuestas
401
No autorizado
Ejemplo de código
curl -X POST "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 (201)Validación creada
{
"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": {}
}
}