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:

csv
Filler,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ónCampoDescripciónFormatoEjemploTipo
1fillerDebe completarse como una cadena vacía ("") y no como null o nil. Es necesario para nuestro procesamiento interno.""Requerido
2external_referenceEs la referencia del payer en el sistema del seller.Caracteres alfanuméricosORD-123456Requerido
3customer_emailRepresenta el email del usuario pagador en la vinculación.Caracteres alfanuméricoscliente@email.comRequerido
4fillerDebe completarse como una cadena vacía (""). Es necesario para nuestro procesamiento interno.""Requerido
5fillerDebe completarse como una cadena vacía (""). Es necesario para nuestro procesamiento interno.""Requerido
6card_numberEs el PAN de la tarjeta.Caracteres numéricos (entre 13 y 19)1234567812345678Requerido
7expiration_monthEs el mes de vencimiento de la tarjeta.Caracteres numéricos (2)01Requerido
8expiration_yearEs 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)27Requerido
9cardholder_nameEs el nombre que aparece en la tarjeta.Utiliza solo letras sin tildes y espacios, evitando números y caracteres especiales como . , ; : - _ / \ ' " & @ + ( ) ñ y ç.ATILIO GARCIARequerido
10fillerDebe 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.csv
  • seller-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_name debe contener solo letras sin tildes y espacios. Evita números y caracteres especiales como . , ; : - _ / \ ' " & @ + ( ) ñ ç o letras con tilde.
  • El campo customer_email debe tener formato de email válido.
  • Los campos filler deben completarse como una cadena vacía (""), nunca como null o nil.

Errores frecuentes en el archivo

Consulta los problemas más comunes al preparar el archivo y cómo resolverlos.

ProblemaEjemplo inválidoCómo corregirlo
cardholder_name con caracteres no permitidosJOSE PEREZ S.A., MARÍA GÓMEZ, JOÃO SILVA, ANA-MARIA, CLIENTE & CIAUsa solo letras sin tildes y espacios. Por ejemplo: JOSE PEREZ, MARIA GOMEZ, JOAO SILVA.
Archivo CSV mal exportadoToda la fila queda entre comillas o se usa otro separadorExporta el archivo como CSV separado por comas y conserva el header exacto del template.
Líneas vacíasUna fila sin datos entre registrosElimina las líneas vacías antes de enviar el archivo.
Tarjeta vencidaexpiration_month=01, expiration_year=24Envía solo tarjetas con fecha de vencimiento futura.
card_number incorrectoToken, card_id o identificador interno en lugar del PANEnvía el PAN plano de la tarjeta, con 13 a 19 dígitos.
customer_email con formato inválidocliente@, cliente.com, cliente@@email.comUsa un email con formato estándar, por ejemplo cliente@email.com.