Mercado Pago
DEVELOPERS
Ingresar
Recursos para IA

Importar tarjetas en el panel de Mercado Pago

La funcionalidad de importación de tarjetas permite a las empresas que ya cuentan con una base de clientes y tarjetas almacenadas migrar esos datos de forma segura a Mercado Pago. Una vez completada la migración, los pagos se procesan a través de la plataforma de Mercado Pago sin interrupciones para los clientes.

Este proceso crea tarjetas tokenizadasRepresentación segura de los datos de una tarjeta mediante un identificador único (token) que reemplaza la información sensible. El token permite procesar pagos sin exponer los datos reales de la tarjeta. de forma masiva a partir del envío de un archivo encriptado que contiene sus datos.

Para acceder a la herramienta de importación de tarjetas, necesitas entrar en contacto previamente con tu representante de negocios. Al finalizar esta etapa, recibirás una URL para acceder a la interfaz de envío del archivo en el panel de Mercado Pago.

Si ocurre algún error o imprevisto durante la integración de esta solución, entra en contacto con tu representante de negocios de Mercado Pago.

Otorgar acceso a colaboradores

Por defecto, el acceso al portal de importación de tarjetas está restringido a usuarios con perfil de administrador. Para permitir que otros colaboradores también puedan usar esta funcionalidad, crea un rol con el permiso correspondiente y asígnalo a los colaboradores deseados.

Preparación del archivo

Prepara un archivo .csv especificando los datos de cada cliente y sus tarjetas. Incluye la primera línea con los encabezados y separa cada campo con comas. Todos los campos son obligatorios. El archivo admite hasta 100.000 filas; si tienes más tarjetas, divide la información en múltiples archivos. El tiempo promedio de creación de tokens es de 60 minutos por cada 10.000 filas. El nombre del archivo .csv debe contener solo letras, números, guiones (-), guiones bajos (_) y puntos (.). Consulta las especificaciones en la siguiente tabla:

OrdenEncabezadoDescripciónFormatoEjemplo
1external_referenceIdentificador único del cliente en tu sistema.AlfanuméricoORD-123456
2customer_emailDirección de correo electrónico del titular.Alfanumérico. El nombre de usuario en el email debe contener al menos 2 caracteres.ej@email.com
3card_numberNúmero de la tarjeta.Numérico, de 13 a 19 dígitos.1234567812345678
4expiration_monthMes de vencimiento.Numérico, de 2 dígitos.01
5expiration_yearAño de vencimiento.Numérico, de 2 dígitos.25
6cardholder_nameNombre que aparece en la tarjeta.Utiliza solo letras sin tildes y espacios, evitando números y caracteres especiales como . , ; : - _ / \ ' " & @ + ( ) ñ y ç.ATILIO GARCIA

A continuación, encontrarás un ejemplo de archivo .csv.

csv
external_reference,customer_email,card_number,expiration_month,expiration_year,cardholder_name
ORD-123456,ej@email.com,1234567812345678,01,25,PABLO SANCHEZ
CLI-789012,test_payer@example.com,5480832801033311,12,26,MARIA GONZALEZ
USR-345678,test_payer@example.com,4509953566233704,06,27,JOAO SILVA
REF-456789,test_payer@example.com,4012888888881881,03,28,CAROLINA PEREZ

Validaciones del archivo

El campo cardholder_name debe contener solo letras sin tildes y espacios, evitando números y caracteres especiales como . , ; : - _ / \ ' " & @ + ( ) ñ y ç.

Encriptación del archivo

El archivo .csv debe ser encriptado antes del envío. El formato esperado es PGPPretty Good Privacy: protocolo de encriptación que garantiza la confidencialidad e integridad de los datos mediante criptografía de clave pública. con extensión .asc o .enc.

A continuación verás el proceso de encriptación utilizando el GnuPG, un software gratuito de encriptación. Puedes utilizar otros métodos siempre que el resultado cumpla con el formato PGP.


Envío del archivo encriptado

  1. Accede a la URL proporcionada por tu representante de negocios.
  2. En la interfaz de Generación de tokens, arrastra o selecciona el archivo encriptado (.asc o .enc).

Pantalla de generación de tokens en lote

  1. Verifica que el nombre del archivo sea correcto y haz clic en Generar Tokens.

Interfaz de carga de archivo

El sistema mostrará el estado "Generando tokens...". La finalización puede tomar varias horas dependiendo del tamaño del archivo. Puedes monitorear el procedimiento en el campo Últimos resultados.

Sección de últimos resultados

Interpretación del archivo de resultados

Una vez completado el procesamiento, consulta el resultado en el Panel de Mercado Pago. Solo los casos procesados completamente con éxito o de forma parcial generan un archivo de resultados.

Ubicación de los resultados

  1. Consulta el estado más reciente de tus envíos en la sección Últimos resultados.
  2. Haz clic en el enlace de descarga para obtener un archivo .csv con el detalle de los tokens generados y los posibles errores.

Estado de procesamiento Historial de resultados

Si completaste la creación de tokens pero aún no procesaste cobros en la plataforma, contacta a tu representante de negocios de Mercado Pago para continuar con el proceso de integración.

Resolución de errores

Si el procesamiento fue parcial, el archivo de resultados incluirá los errores encontrados. Consulta la siguiente tabla para identificar y resolver cada tipo de error.

Ejemplo de archivo de resultados

ErrorDescripciónResolución
Registro del cliente generado incorrectamenteError al crear el registro del cliente o al agregar la tarjeta.Revisa los datos del cliente y de la tarjeta. Si el error persiste, contacta a tu representante de negocios de Mercado Pago.
Error al vincular una tarjetaNo fue posible determinar el método de pago.Revisa los datos de la tarjeta o utiliza otra tarjeta.
Token de tarjeta generado incorrectamenteSe ingresaron datos de tarjeta incorrectos.Revisa el número de tarjeta y la fecha de vencimiento.
Fecha de vencimiento expiradaLas fechas de vencimiento ingresadas corresponden a fechas pasadas.Verifica que las fechas de vencimiento sean futuras.
Formato de email inválidoEl email no cumple con el formato permitido (ejemplo@email.com).Corrige el formato del email.
Sintaxis del email inválidaEl email contiene caracteres no permitidos.Revisa los caracteres del email.
La tarjeta es inválidaLos datos registrados corresponden a una tarjeta inválida.Utiliza otra tarjeta.

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.

Una vez que hayas identificado los errores, repara y carga un nuevo archivo únicamente con los datos corregidos para los registros que presentaron problemas. Puedes realizar tantas importaciones como necesites.

AnteriorFormato de salida para batch paymentsConoce cómo generar una salida para batch payments.
PróximoCobros y devoluciones masivos por el portalAprende a realizar cobros y devoluciones masivos de tarjetas directamente desde el portal de Mercado Pago.