POST
/users/v2/kyc/{user_id}/flow/{flow_id}/fileSubir archivos de validación
El endpoint POST /users/v2/kyc/{user_id}/flow/{flow_id}/file permite subir un documento de identidad o archivo para una validación KYC específica.
Formato de la solicitud
La solicitud debe enviarse como multipart/form-data con los siguientes campos:
file: el archivo del documento (obligatorio). Máximo 10 MiB. Formatos aceptados: JPEG, PNG, PDF, entre otros.type: tipo de documento (obligatorio). Ejemplos:PASSPORT,ID_CARD,DRIVER_LICENSE.side: lado del documento (opcional). Requerido cuando el tipo de documento exige múltiples lados. Valores:FRONT,BACK.
Consideraciones
Luego de una carga exitosa, la respuesta incluye el estado actualizado de la validación, reflejando el nuevo documento subido.
Parámetros disponibles
Header Parameters
AuthorizationStringrequired
Path Parameters
user_idStringrequired
flow_idStringrequired
Cuerpo de solicitud
multipart/form-datafilestringbinaryrequired
typeenumrequired
sideenum
Detalle de respuestas
401
No autorizado
Ejemplo de solicitud
{
"file": "example_value",
"type": "PASSPORT",
"side": "FRONT"
}Ejemplo de código
curl -X POST "https://api.pomelo.la/users/v2/kyc/example_value/flow/global-cards/file" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"file": "example_value",
"type": "PASSPORT",
"side": "FRONT"
}'Ejemplo de respuesta (201)Archivo cargado exitosamente
{
"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": {}
}
}