La base de todo el proceso es un archivo .csv que debe prepararse con los datos de los clientes y las tarjetas, siguiendo especificaciones estrictas. La precisión en este paso es fundamental para lograr éxito en los cobros.

csv
Copiar
external_reference;card_id;payer_id;amount;reason;echo_data;soft_descriptor
ref-4324_08_2026;3154;1234-1234;299;Ejemplo payment;dato random;CompanyName
ref-4325_08_2026;3154;1234-1234;204;Ejemplo payment;dato random;CompanyName

Asegúrate de que tu archivo cumpla con las siguientes especificaciones y orden de datos:

Puntos clave a considerar:

• Formato del archivo: el único formato aceptado es .csv.

• Encabezado: completa la primera línea con los encabezados que aparecen en la tabla anterior.

• Separación de datos: usa punto y coma (;) para separar cada campo.

• Pertenencia: el payer_id y el card_id deben corresponder a un cliente y una tarjeta vinculados a la cuenta del vendedor en Mercado Pago.

• Límites del archivo: el tamaño máximo es de 200.000 filas o 15 MB. Si tienes más filas, usa múltiples archivos.

• Nombre del archivo: usa solo letras, números, guiones (-), guiones bajos (_) y puntos (.).

Luego de preparar y revisar el archivo, debes cargarlo en la interfaz de Mercado Pago. Solo los usuarios con rol de Administrador en tu cuenta de Mercado Pago pueden realizar este paso. Si no tienes este permiso, contacta al administrador de tu cuenta para que haga el envío o actualice tu nivel de acceso a través de la sección Colaboradores.

Para eso, accede a la URL proporcionada por el equipo de soporte o tu representante de negocios de Mercado Pago y sigue los pasos a continuación.

1. Carga el archivo: en la interfaz "Gestiona tus pagos de forma masiva", selecciona o arrastra el archivo .csv al área indicada.

2. Confirma el envío: verifica que el nombre del archivo seleccionado sea el correcto y haz clic en "Procesar archivo" para iniciar el procesamiento de los cobros.

Mercado Pago aplica mecanismos automáticos para evitar el procesamiento de archivos duplicados:

• Nombre de archivo ya utilizado: se verifica si el nombre del archivo ya fue utilizado en un procesamiento anterior.
• Contenido duplicado: se impide el procesamiento de archivos cuyo contenido sea idéntico al de otro archivo ya procesado.

Aunque existen estos mecanismos automáticos, es tu responsabilidad revisar el nombre y el contenido del archivo antes de enviarlo para evitar cobros duplicados.

Después del envío, Mercado Pago ejecuta validaciones internas del archivo y da inicio al procesamiento de los pagos. A las 24 horas del envío ya es posible consultar el estado actualizado del procesamiento.

Para encontrar los resultados, accede a una de estas opciones:

• La pantalla principal de "Gestiona tus pagos de forma masiva", donde se muestra el último archivo enviado con su estado y la opción "Consultar histórico".
• La pantalla completa de "Histórico de archivos", accesible desde "Consultar histórico".

En "Histórico de archivos" encontrarás el nombre del archivo, el tipo (Cobros), el estado del procesamiento, la fecha de última actualización y la acción disponible según el estado.

El tipo de información disponible depende del estado del procesamiento:

Consulta las FAQs disponibles en la interfaz o contacta al Soporte de Mercado Pago si necesitas asistencia para identificar el motivo del error.

A continuación se muestra un ejemplo del contenido que encontrarás en el archivo de resultado:

csv
Copiar
sequential_order;external_reference;amount;reason;echoData;payment_status;payment_detail;state_detail_code;payment_id;payment_date
1;2205353035;1000;"Cobro ejemplo 1";valido;Paid;accredited;E000;115629505401;"23/06/2025 15:58:36"
2;1827490885;2000;"Cobro ejemplo 2";valido;Paid;accredited;E000;115629505403;"23/06/2025 15:58:36"
3;2205353035;1000;"Cobro ejemplo 3";valido;Unpaid;"No fue posible procesar el pago.";E001;115629504412;
4;1827490885;2000;"Cobro ejemplo 4";valido;Unpaid;"El Customer ID o Card ID era inválido";E004;115629505414;

Los valores posibles de payment_status, payment_detail y state_detail_code son los siguientes:

La base de todo el proceso es un archivo .csv que debe prepararse con los datos de las devoluciones, siguiendo especificaciones estrictas. La precisión en este paso es fundamental para lograr éxito en las devoluciones.

csv
Copiar
payment_id;external_reference;amount
133008198979;ext_ref_1;100
142083165120;ext_ref_2;200

Asegúrate de que tu archivo cumpla con las siguientes especificaciones y orden de datos:

Puntos clave a considerar:

• Formato del archivo: el único formato aceptado es .csv.

• Encabezado: completa la primera línea con los encabezados que aparecen en la tabla anterior.

• Separación de datos: usa punto y coma (;) para separar cada campo.

• Montos válidos: los valores deben ser positivos, conformes con la moneda del país y menores o iguales al valor de la transacción original.

• Caracteres especiales: no se permiten caracteres especiales como ñ, &, %, !, ? ni similares.

• Nombre del archivo: usa solo letras, números, guiones (-), guiones bajos (_) y puntos (.).

• Límites del archivo: el tamaño máximo es de 200.000 filas o 15 MB. Si tienes más filas, usa múltiples archivos.

Luego de preparar y revisar el archivo, debes cargarlo en la interfaz de Mercado Pago. Solo los usuarios con rol de Administrador en tu cuenta de Mercado Pago pueden realizar este paso. Si no tienes este permiso, contacta al administrador de tu cuenta para que haga el envío o actualice tu nivel de acceso a través de la sección Colaboradores.

Para eso, accede a la URL proporcionada por el equipo de soporte o tu representante de negocios de Mercado Pago y sigue los pasos a continuación.

1. Carga el archivo: en la interfaz "Gestiona tus pagos de forma masiva", selecciona o arrastra el archivo .csv de devolución al área indicada.

2. Confirma el envío: verifica que el nombre del archivo seleccionado sea el correcto y haz clic en "Procesar archivo" para iniciar el procesamiento de las devoluciones.

Mercado Pago aplica mecanismos automáticos para evitar el procesamiento de archivos duplicados:

• Nombre de archivo ya utilizado: se verifica si el nombre del archivo ya fue utilizado en un procesamiento anterior.
• Contenido duplicado: se impide el procesamiento de archivos cuyo contenido sea idéntico al de otro archivo ya procesado.

Aunque existen estos mecanismos automáticos, es tu responsabilidad revisar el nombre y el contenido del archivo antes de enviarlo para evitar devoluciones duplicadas.

Después del envío, Mercado Pago ejecuta validaciones internas del archivo y da inicio al procesamiento de las devoluciones. A las 24 horas del envío ya es posible consultar el estado actualizado del procesamiento.

Para encontrar los resultados, accede a una de estas opciones:

• La pantalla principal de "Gestiona tus pagos de forma masiva", donde se muestra el último archivo enviado con su estado y la opción "Consultar histórico".
• La pantalla completa de "Histórico de archivos", accesible desde "Consultar histórico".

En "Histórico de archivos" encontrarás el nombre del archivo, el tipo (Reembolso), el estado del procesamiento, la fecha de última actualización y la acción disponible según el estado.

El tipo de información disponible depende del estado del procesamiento:

Consulta las FAQs disponibles en la interfaz o contacta al Soporte de Mercado Pago si necesitas asistencia para identificar el motivo del error.

A continuación se muestra un ejemplo del contenido que encontrarás en el archivo de resultado:

csv
Copiar
sequential_order;external_reference;amount;refunds_status;refund_detail;payment_id
1;ext_ref1;20398,00;refunded;refunded;1885556855
2;ext_ref2;10423,00;refunded;refunded;1885556854
3;ext_ref3;874,00;refunded;refunded;1885556853

Para más información o asistencia durante el proceso de devoluciones, contacta al soporte de Mercado Pago o a tu representante de negocios.