POST
/users/v2/kyc/{user_id}/flow/{flow_id}/declared-personal-dataEnviar declaración de datos personales
El endpoint POST /users/v2/kyc/{user_id}/flow/{flow_id}/declared-personal-data permite enviar la información personal autodeclarada del usuario para el flujo KYC.
Consideraciones
El body es un objeto JSON plano donde las claves son los nombres de campos definidos en la configuración de datos declarados del flujo (ver endpoint GET /users/v2/kyc/requirements/declared-personal-data).
Todos los campos marcados como required: true en la configuración deben estar presentes y no vacíos.
Los campos de tipo enum deben usar uno de los valores listados en el array options.
Los campos de tipo bool deben ser el string "true" o "false". Si el campo tiene must_be_value, el valor enviado debe coincidir exactamente.
Ejemplo para el flujo global-cards
{
"occupation": "Software Engineer",
"industry_you_work_for": "Information",
"work_status": "Full Time",
"source_of_funds": "Salary",
"expected_month_volume": "$2,000 - $3,999",
"card_terms_conditions_accept": "true"
}
Parámetros disponibles
Header Parameters
AuthorizationStringrequired
Path Parameters
user_idStringrequired
flow_idStringrequired
Cuerpo de solicitud
application/jsonEsquema no definido o sin propiedades.
Detalle de respuestas
401
No autorizado
Ejemplo de solicitud
{
"occupation": "Software Engineer",
"industry_you_work_for": "Information",
"work_status": "Full Time",
"source_of_funds": "Salary",
"expected_month_volume": "$2,000 - $3,999",
"card_terms_conditions_accept": "true"
}Ejemplo de código
curl -X POST "https://api.pomelo.la/users/v2/kyc/example_value/flow/global-cards/declared-personal-data" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"occupation": "Software Engineer",
"industry_you_work_for": "Information",
"work_status": "Full Time",
"source_of_funds": "Salary",
"expected_month_volume": "$2,000 - $3,999",
"card_terms_conditions_accept": "true"
}'Ejemplo de respuesta (200)Datos aceptados
{
"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": {}
}
}