KYC
Valida la identidad de las personas que usan tus productos y previene el fraude desde el alta.
Introducción
Cuando una persona se registra en tu plataforma, necesitas confirmar que es realmente quien dice ser y que sus datos son correctos. Sin esa validación, te expones a que alguien use una identidad falsa o robada para acceder a tus tarjetas.
En Pomelo, validamos la identidad de tus clientes personas físicas (KYC, Know Your Customer) combinando biometría, bureaus de información y una revisión manual de nuestro equipo de expertos.
Funcionamiento
Para corroborar la información de cada persona, usamos bureaus de información locales e internacionales y servicios de biometría. Le solicitamos sus datos personales, fotos del frente y dorso de su documento de identidad y una selfie.
En cada etapa hacemos validaciones automáticas para agilizar el flujo y, al final, nuestro equipo realiza una revisión manual en detalle. El proceso puede llevar hasta 48 horas hábiles.
Etapas de una sesión
Cada sesión de validación de una persona física tiene 8 etapas (steps). En la API de KYC encontrarás cada etapa con el nombre de la columna "Step en la API".
| Etapa | Step en la API | Qué pasa en esta etapa |
|---|---|---|
| 1. Aceptación de TyC | TERMS | Tu cliente acepta nuestros términos y condiciones, para cumplir con las regulaciones locales y las políticas de seguridad. |
| 2. Prueba de vida | LIVENESS | Tu cliente se toma una foto en tiempo real con la cámara de su dispositivo y realiza una serie de acciones, para confirmar que es realmente la persona que intenta registrarse. |
| 3. Coincidencia selfie / documento | MATCH_ID | Comparamos la foto del paso anterior con la foto del documento para confirmar la identidad. |
| 4. OCR | OCR | Extraemos la información del documento con reconocimiento óptico de caracteres (OCR) y la validamos. |
| 5. Formulario de datos | DATA_ENRICHMENT_MANUAL | Recabamos los datos personales de tu cliente, que varían según el país. |
| 6. Validación de datos | GOVERMENTAL_CHECK_DATA | Verificamos la información en bases de datos gubernamentales y confirmamos que coincide con los datos de los pasos anteriores. |
| 7. Validación de foto | GOVERMENTAL_CHECK_SELFIE | Comparamos la foto con bases de datos gubernamentales y otras fuentes, para confirmar que no es una imagen manipulada o falsa. |
| 8. Validación de riesgo | EXCLUSION_CHECK | Hacemos un screening AML (prevención de lavado de activos y financiación del terrorismo) para confirmar que la persona no figura en listas de riesgo locales o internacionales, ni en listas de personas expuestas políticamente. |
Cuando tu cliente completa todo el proceso, podrá solicitar una tarjeta.
Integración vía API
Es la opción ideal si quieres control total sobre la experiencia de validación y ya cuentas con los datos de tus usuarios.
Recopilas los datos y la documentación desde tu plataforma y nos los envías a través de los endpoints de KYC. Recibirás las actualizaciones del estado de la sesión vía webhook.
Tendrás que usar esta integración:
- Siempre que contrates Cards en 🇧🇷 Brasil o en 🇨🇱 Chile.
- Cuando contrates Cards en 🇦🇷 Argentina y Pomelo actúe como sujeto obligado.
Pasos para la integración
- Crea el usuario con la API de Users. Para generar el
user_idsolo necesitas el mail que identifica al usuario en tu plataforma. - Crea una sesión de validación con la API de KYC y selecciona "[País] - [Accounts/Cards] - API". Para esto necesitas el
user_iddel paso anterior. - Sube los documentos requeridos con el endpoint "Subir Archivo" de la API de KYC. Haz una llamada por cada documento.
- Recibirás el resultado de la validación vía webhook, en el endpoint que definas.
Si la sesión termina en estado NOT_VALIDATED, el webhook incluirá el motivo, para que puedas explicárselo a tu cliente y pueda intentarlo nuevamente.
Datos, documentos y fotos
Para avanzar con la sesión, tendrás que enviarnos una selfie de tu cliente y una foto del frente y otra del dorso de su documento de identidad. Encontrarás la nomenclatura de cada archivo en la API de KYC.
| 🇦🇷 Argentina | 🇧🇷 Brasil | 🇨🇱 Chile | |
|---|---|---|---|
| Documento aceptado | DNI (documento nacional de identidad). | RG (Registro Geral) o CNH (licencia de conducir). | Cédula de identidad (CI). |
| A tener en cuenta | — | Tu cliente tiene que capturar el frente y el dorso de la CNH por separado. | — |
Datos
Verificamos todos los datos con bureaus de información para confirmar que la persona es realmente quien dice ser. Los datos que envíes tienen que coincidir exactamente con los del documento de identidad.
| ✅ | ❌ |
|---|---|
| Constante Formentucho Junior | Junior Formentucho |
Fotos del documento
- El frente del documento y el rostro de la selfie tienen que coincidir.
- La foto tiene que ser a color y sin ningún tratamiento (sin recortes, ajustes de contraste, etc.).
- Tiene que verse el documento completo, ocupando al menos el 80 % de la imagen y sin mostrar el entorno.
- El documento va en modo paisaje, con la cámara lo más cerca posible y sin inclinaciones.
- La iluminación tiene que ser buena, preferentemente natural, sin reflejos ni sombras.
- El fondo no puede ser estampado.
- Los dedos no pueden tapar ninguna parte del documento.
- El documento va sin fundas ni protectores plásticos.
- El documento no puede tener marcas de tinta ni dobleces.
Selfie
- La foto tiene que ser a color y sin ningún tratamiento (sin recortes, ajustes de contraste, etc.).
- La iluminación tiene que ser buena, preferentemente natural, sin reflejos ni sombras.
- La cámara va a la altura de los ojos, con los ojos abiertos de forma natural y las pupilas y el iris visibles.
- El rostro tiene que ocupar al menos el 80 % de la imagen, en modo retrato (vertical).
- El rostro va centrado, sin inclinar, mirando directo a la cámara, con la cabeza erguida y los hombros paralelos a la cámara.
- La expresión tiene que ser neutra, sin sonreír.
- El cabello no puede tapar los ojos, ni total ni parcialmente.
- Sin sombreros, gorras, máscaras ni nada que oculte parte del rostro.
- Sin anteojos. Si no es posible quitarlos, sin reflejos de flash o de luz en los lentes, sin lentes de colores y sin monturas que tapen los ojos.
- Sin maquillaje, aros ni lentes de contacto de colores.
- El fondo tiene que ser liso, claro (preferentemente blanco) y sin objetos visibles, como personas, muebles, papel pintado o plantas.
- La selfie no se toma con el documento en la mano.

Ejemplos y templates por país
Te recomendamos usar estos templates como guía para tus usuarios:






Preguntas frecuentes
¿Cuánto tarda la validación de una persona?
Hasta 48 horas hábiles, porque además de las validaciones automáticas nuestro equipo hace una revisión manual.
¿Puedo enviar otro documento, como el pasaporte?
No. Solo aceptamos el DNI en 🇦🇷 Argentina, el RG o la CNH en 🇧🇷 Brasil y la cédula de identidad en 🇨🇱 Chile.
¿Puedo recortar o mejorar las fotos antes de enviarlas?
No. Las fotos tienen que llegar a color y sin ningún tratamiento (sin recortes ni ajustes de contraste).
¿Qué pasa si la sesión no se valida?
Recibirás el motivo en el webhook, para que tu cliente corrija lo necesario e intente nuevamente.