Recursos para IA
Formato de entrada para migración de bóvedas
El formato del archivo de entrada debe ser CSV separado por comas (,), con codificación UTF-8 sin BOM, y el nombre del archivo debe seguir la convención definida en la sección Nomenclatura del archivo.
A continuación, te mostramos un ejemplo:
csvFiller,external_reference,customer_email,Filler,Filler,card_number,expiration_month,expiration_year,cardholder_name,Filler ,217307543,test1@gmail.com,,,4356141052114191,11,27,Mary Meir, ,485342254,test2@gmail.com,,,4356141052114192,02,28,Jhon Doe,
Todos los campos son obligatorios. A continuación, se encuentran las descripciones detalladas de cada campo, su posición en el CSV y sus particularidades:
| Posición | Campo | Descripción | Formato | Ejemplo | Tipo |
| 1 | filler | Debe completarse como una cadena vacía ("") y no como null o nil. Es necesario para nuestro procesamiento interno. | — | "" | Requerido |
| 2 | external_reference | Es la referencia del payer en el sistema del seller. | Caracteres alfanuméricos | ORD-123456 | Requerido |
| 3 | customer_email | Representa el email del usuario pagador en la vinculación. | Caracteres alfanuméricos | cliente@email.com | Requerido |
| 4 | filler | Debe completarse como una cadena vacía (""). Es necesario para nuestro procesamiento interno. | — | "" | Requerido |
| 5 | filler | Debe completarse como una cadena vacía (""). Es necesario para nuestro procesamiento interno. | — | "" | Requerido |
| 6 | card_number | Es el PAN de la tarjeta. | Caracteres numéricos (entre 13 y 19) | 1234567812345678 | Requerido |
| 7 | expiration_month | Es el mes de vencimiento de la tarjeta. | Caracteres numéricos (2) | 01 | Requerido |
| 8 | expiration_year | Es el año de vencimiento de la tarjeta, en formato de 2 dígitos (YY) correspondiente al siglo XXI (ej: 27 = 2027). | Caracteres numéricos (2) | 27 | Requerido |
| 9 | cardholder_name | Es el nombre que aparece en la tarjeta. | Utiliza solo letras sin tildes y espacios, evitando números y caracteres especiales como . , ; : - _ / \ ' " & @ + ( ) ñ y ç. | ATILIO GARCIA | Requerido |
| 10 | filler | Debe completarse como una cadena vacía (""). Es necesario para nuestro procesamiento interno. | — | "" | Requerido |
Nomenclatura del archivo
El nombre del archivo .csv debe contener solo letras, números, guiones (-), guiones bajos (_) y puntos (.).
Ejemplos válidos:
migracion_boveda_2027.csvseller-123_customers.csv
Ejemplos inválidos:
migración bóveda.csv(espacios y caracteres especiales no permitidos)archivo@clientes.csv(el carácter@no está permitido)
Validaciones del archivo de entrada
A continuación, detallamos las validaciones que se realizan durante el procesamiento del archivo de entrada:
- El archivo debe estar codificado en UTF-8 sin BOM.
- El límite de contenido es de 400.000 líneas por archivo. Si el volumen supera este límite, se recomienda dividirlo en múltiples archivos.
- El límite del archivo es de 100 MB.
- Es importante resaltar que el límite para asociar tarjetas a un único correo electrónico es de 20 tarjetas. Si se supera este límite, la línea correspondiente no podrá ser procesada.
- La fecha de vencimiento de la tarjeta debe ser una fecha futura.
- El campo
cardholder_namedebe contener solo letras sin tildes y espacios. Evita números y caracteres especiales como.,;:-_/\'"&@+()ñço letras con tilde. - El campo
customer_emaildebe tener formato de email válido. - Los campos
fillerdeben completarse como una cadena vacía (""), nunca comonullonil.
Errores frecuentes en el archivo
Consulta los problemas más comunes al preparar el archivo y cómo resolverlos.
| Problema | Ejemplo inválido | Cómo corregirlo |
cardholder_name con caracteres no permitidos | JOSE PEREZ S.A., MARÍA GÓMEZ, JOÃO SILVA, ANA-MARIA, CLIENTE & CIA | Usa solo letras sin tildes y espacios. Por ejemplo: JOSE PEREZ, MARIA GOMEZ, JOAO SILVA. |
| Archivo CSV mal exportado | Toda la fila queda entre comillas o se usa otro separador | Exporta el archivo como CSV separado por comas y conserva el header exacto del template. |
| Líneas vacías | Una fila sin datos entre registros | Elimina las líneas vacías antes de enviar el archivo. |
| Tarjeta vencida | expiration_month=01, expiration_year=24 | Envía solo tarjetas con fecha de vencimiento futura. |
card_number incorrecto | Token, card_id o identificador interno en lugar del PAN | Envía el PAN plano de la tarjeta, con 13 a 19 dígitos. |
customer_email con formato inválido | cliente@, cliente.com, cliente@@email.com | Usa un email con formato estándar, por ejemplo cliente@email.com. |