Nombre en la tarjeta
Imprimimos el nombre de tus clientes de forma clara y ajustada a las convenciones de cada país, con la opción de personalizarlo si lo necesitas.
Introducción
Cuando emites una tarjeta, necesitas que el nombre del titular se vea completo y legible, incluso cuando es más largo que el espacio disponible para imprimirlo.
Desde Pomelo, aplicamos automáticamente reglas de abreviación pensadas para las convenciones de nombres de cada país, de forma que el resultado entre en el límite de la tarjeta conservando la mayor cantidad de información posible.
Si necesitas más control sobre el resultado, también puedes definir tú mismo el nombre que se imprime.
Alcance
Esta lógica aplica a la emisión de tarjetas en todos los países donde operamos.
Funcionamiento
Al crear una tarjeta, generamos el nombre a imprimir a partir de los datos del perfil del usuario.
El límite combinado entre el nombre y el apellido es de 19 caracteres, a lo que se suma el espacio que los separa. Es decir, el límite total es de 20 caracteres.
El proceso es el siguiente:
- Sanitizamos el nombre y el apellido por separado.
- Si el resultado entra en el límite, lo usamos tal cual.
- Si lo supera, aplicamos una secuencia de reglas de abreviación progresivas y específicas para cada país, hasta que el nombre entre en el límite. Cada regla se aplica solo si la anterior no fue suficiente.
Sanitización
Antes de aplicar cualquier regla, normalizamos el nombre y el apellido: eliminamos espacios al inicio y al final, y colapsamos espacios múltiples a uno solo.
Por ejemplo: " Ana Maria " se convierte en "Ana Maria".
Lógica por país
| País | Cómo se abrevia | Ejemplo |
|---|---|---|
| 🇦🇷 Argentina, 🇲🇽 México, 🇨🇱 Chile, 🇵🇪 Perú, 🇵🇦 Panamá, 🇵🇷 Puerto Rico, 🏳️ Otros | Mantenemos el primer nombre completo y abreviamos el segundo a su inicial. Conservamos el apellido hasta en 2 componentes, abreviando el segundo si hace falta. Si aún así el nombre no entra en el límite, recortamos primero el nombre y luego el apellido. | "Ana Maria" "Perez Gomez" → Ana M Perez G |
| 🇧🇷 Brasil | Filtramos partículas como DA, DE, DO, DOS y DAS, conservamos el último apellido, abreviamos nombres adicionales a su inicial y, si aun así el resultado excede el límite, lo recortamos. | "Ana Lucia Josefina" "Silva Santos" → Ana L J Santos |
| 🇨🇴 Colombia | Conservamos solo el primer nombre y el primer apellido. Si sigue siendo largo, abreviamos el nombre a su inicial y recortamos lo que haga falta. | "Alexander Fernando" "Gomez Lopez" → Alexander Gomez |
DA, DE, DO, DOS, DAS) solo se aplica cuando el nombre supera el límite de 19 caracteres. Si el nombre ya entra en el límite, las partículas se conservan.
Personalización del nombre
Si necesitas imprimir un nombre distinto al que resulta de las reglas automáticas (por ejemplo, un apodo o una forma abreviada elegida por tu cliente), puedes enviarlo directamente en el campo name_on_card utilizando el endpoint de creación de tarjeta (create_card).
Preguntas frecuentes
¿Hay un límite de caracteres para el nombre que se imprime en la tarjeta?
Sí, 19 caracteres combinados entre nombre y apellido. El texto final impreso puede tener hasta 20 caracteres al contar el espacio separador.
¿Qué pasa si el nombre de mi cliente es más largo que el límite permitido?
Lo abreviamos automáticamente de forma progresiva (por ejemplo, usando la inicial del segundo nombre o apellido) hasta que entre en el límite, priorizando conservar la mayor parte de información posible.
¿La forma de abreviar el nombre es igual en todos los países?
No. Ajustamos la lógica según las convenciones de nombres de cada país para que el resultado sea lo más natural posible.
¿Puedo definir el nombre exacto que se imprime en la tarjeta en lugar de que se abrevie automáticamente?
Sí, a través del campo name_on_card al crear la tarjeta. Debes habilitar la opción desde el grupo de afinidad.
¿Qué pasa si intento enviar un nombre personalizado sin tener la opción name_on_card habilitada?
La API devuelve un error de validación y la tarjeta no se crea con ese valor.
¿Qué caracteres puedo usar en el nombre?
Solo letras y espacios, hasta 19 caracteres. No se admiten tildes ni caracteres especiales.
¿Si personalizo el nombre en la tarjeta, se ve afectada la seguridad de los datos del titular?
No. El nombre personalizado solo afecta lo que se ve impreso en la tarjeta. Los datos protegidos siguen derivándose del perfil del usuario.
¿Qué pasa si el nombre tiene espacios de más o mal escritos?
Los normalizamos automáticamente antes de imprimirlo: eliminamos espacios extra al inicio, al final y entre palabras.