VTEX - Plugins y plataformas - Mercado Pago Developers
Developers
Referencia de API
Soporte
Ingresar

    Inicio

    Empieza por aquí

    Cobros online

    Checkout Pro

    Checkout API

    Link de pago

    Marketplace

    Mobile Checkout

    Web Tokenize Checkout

    Pagos presenciales

    Código QR

    Plugins y plataformas

    WooCommerce

    Prestashop

    Magento 2

    Shopify

    VTEX

    SDKs

    Notificaciones

    Webhooks

    IPN

    Gestión de cuenta

    Reportes

    Obtener pagos

    Mejora la aprobación

    Gestión de contracargos

    Devoluciones y cancelaciones

    Requisitos para salir a producción

    Recursos

    Localización

    Changelog

    Status

EN ESTA PÁGINA

Sugiere cambios
Ayúdanos a mejorar la documentación
¿Viste información errónea, te gustaría que expliquemos algo más o que mejoremos nuestras guías? Déjanos tus sugerencias en GitHub.

VTEX

¿Qué es VTEX?

VTEX es una plataforma de e-commerce que permite recibir pagos con Mercado Pago.

Puedes ofrecer a tus clientes la posibilidad de pagar con tarjetas de crédito o medios de pago en efectivo. Como también, tienes la opción de recibir pagos directamente desde el sitio web de Mercado Pago.

Etapas para configurar

Los pasos para comenzar a operar con Mercado Pago son los siguientes:

  1. Crea una cuenta de vendedor en Mercado Pago si aún no tiene una.
  2. Registra la afiliación con Mercado Pago.
  3. Configura las condiciones de pago.
  4. Agrega el device fingerprint.

Configurar la afiliación de pasarela con Mercado Pago

Para crear una afiliación de pasarela de pago con Mercado Pago, sigue estos pasos:

  1. Accede a las configuraciones del módulo en el panel de administración de tu tienda.
  2. En la pestaña de Afiliación de Gateway, haz clic en el botón +.
  3. Ingresa en el conector MercadoPagoV1.
  4. Completa los campos correspondientes y guarda los cambios.

Configurar la afiliación de pasarela con Mercado Pago

Para crear una afiliación de pasarela de pago con Mercado Pago, sigue estos pasos:

  1. Accede a las configuraciones del módulo en el panel de administración de tu tienda.
  2. En la pestaña de Afiliación de Gateway, haz clic en el botón +.
  3. Ingresa en el conector MercadoPagoV1.
  4. Completa los campos correspondientes y guarda los cambios.
CamposDatos necesarios
Nombre de afiliaciónDefine el nombre que identificará a tu afiliación.
OAuth loginNo es necesario. Dejar como está.
PublicKeyRefiere a las credenciales de tu cuenta de Mercado Pago. Completa con tu clave pública.
AccessTokenRefiere a las credenciales de tu cuenta de Mercado Pago. Completa con tu clave privada.
RefreshTokenDejar en blanco.
ExpiredTokenInDejar en blanco.
Merchant Account IdDejar en blanco.
Processing ModeElige agregador como modo de procesamiento a partir de MercadoPagoV1.
CountryNameUruguay.
Bill due date in daysDejar en 1.
SoftDescriptorIndica el nombre que va a aparecer para identificar una transacción de tu tienda en el resumen de la tarjeta del usuario.
DescriptionEscribe una breve descripción de tu negocio (opcional).
CategoryIdElige la categoría de tus productos.
Financial InstitutionDejar en blanco.
External InstallmentsElegir Yes / Sí. Usa las opciones de pago directamente de tu cuenta de Mercado Pago.
AntifraudElegir Yes / Sí.
Time ZoneIndica la región que define tu horario local.
Mercado Pago 3P payment due dateDeshabilitado.
3P payment due date after Mercado Pago expirationDeshabilitado.
OrderExpirationHoursElegir 1 hora. Este campo define cada cuántas horas quieres que el sistema verifique el estado del pedido antes de que caduque. Si esta opción no se cumple, se configura al patrón de 192 horas.
MaxInstallmentsElige la cantidad de cuotas máximas que quieres ofrecer en Mercado pago.
Categoria PrincipalSelecciona la categoría correspondiente a su tienda.
Early Security CapturePuede desactivar la función o elegir en cuánto tiempo desea realizar la captura (después de que se haya aprobado la transacción y se haya completado el análisis antifraude).
Importante
El campo Early Security Capture no se encuentra disponible por el momento para Uruguay.

Imagen Afiliación

¡Y listo! Tu afiliación con Mercado Pago ya se encuentra activa.

Configura las condiciones de pago

Luego de tener creada tu afiliación con Mercado Pago, puedes ofrecer pagos con tarjetas de crédito o medios de pago en efectivo. Como también, elegir la opción de recibir pagos directamente en el Checkout Pro.

Condición de pagos para el Checkout de VTEX

Para poder utilizar este tipo de checkout se tienen que configurar los medios de pago por separado:

  1. Tarjetas de crédito
  2. Efectivo
  3. Tarjetas de crédito locales

Condición de pagos para tarjeta de crédito

Para crear una condición de pagos con tarjeta de crédito, sigue estos pasos:

  1. En el panel de administración, ingresa en Configuraciones de medios de pago.
  2. En la pestaña Condiciones de pago, haz clic en +.
  3. Luego, en la sección de Tarjetas de crédito, elige el medio de pago que quieras agregar. Se deben agregar Visa, MasterCard y Diners.
  4. Nombra la regla para ayudar facilitar la identificación y activa la condición en el campo Status.
  5. En el campo Proceso con la afiliación, elige como afiliación a MercadoPagoV1.
  6. En la opción de cuotas, selecciona cuotas automáticas. Esto te permite usar la configuración de tu cuenta de Mercado Pago.
  7. Haz clic en Guardar.
Importante
Las cuotas deben quedar configuradas como automáticas para evitar problemas al procesar los pagos. Vamos a tomar las cuotas habilitadas en tu cuenta de Mercado Pago según corresponda.

Imagen tarjeta


Condición de pagos para medios de pago en efectivo

Para crear una condición de pago con medios de pago en efectivo, sigue estos pasos:

  1. En el panel de administración, ingresa en Configuraciones de medios de pago.
  2. En la pestaña Condiciones de pago, haz clic en +.
  3. En la sección Factura, elige Boleto bancario para agregar el medio de pago.
  4. Nombra la regla para ayudar facilitar la identificación y activa la condición en el campo Status.
  5. En el campo Proceso con la afiliación, elige como afiliación a MercadoPagoV1.
  6. Haz clic en Guardar.

En VTEX, al seleccionar Boleto Bancario se incluyen todos los medios de pagos disponibles del país:

Tipo de medio de pagoMedio de pago
ticketAbitab
ticketRedpagos

Imagen efectivo


Condición de pagos con medios de pagos personalizados

Los medios de pago personalizado permite sumar a VTEX tarjetas de crédito locales que VTEX no integra como una opción nativo y se pueden utilizar con Mercado Pago.

Para crear esta condición de pago, sigue estos pasos:

  1. En el panel de administración, ingresa en Configuraciones de medios de pago.
  2. En la pestaña Pagos personalizados, busca la sección Cobrands y haz clic en Configurar.
  3. Se desplegará un formulario donde deberás ingresar Nombre, Descripción, Medio de pago (la marca bandera), Bines (validar en Mercado Pago los mismos) y el Código de Medio de Pago (es el nombre del medio de pago en Mercado Pago).
  4. Haz clic en Guardar.
  5. En la pestaña Planes de Pago, haz clic en +.
  6. En la sección Pago personalizado, elige el medio de pago que habías creado para agregar el medio de pago.
  7. Nombra la regla para ayudar facilitar la identificación y activa la condición en el campo Status.
  8. En el campo Proceso con la afiliación, elige como afiliación a MercadoPagoV1.
  9. Haz clic en Guardar.
Importante
Las cuotas deben quedar configuradas como automáticas para evitar problemas al procesar los pagos. Vamos a tomar las cuotas habilitadas en tu cuenta de Mercado Pago según corresponda.

En VTEX, los medios de pago personalizados que se pueden agregar son:

TipoMedio de pagoBandera de la tarjetaBinesCódigo de pago del adquirente
credit_cardOCAMastercard589892, 542991, 549530, 549564, 549571, 549576oca
credit_cardCreditelMastercard601933creditel
credit_cardLiderMastercard501088,501109,505863,505866,505867,505868,505869,505870,505871,505872lider

Imagen personalizado

Condición de pagos con Checkout Pro

Checkout Pro es la integración que te permite cobrar a través de nuestro formulario web de manera simple, rápida y segura.

Configuración de medios de pago Mercado Pago

El comprador será redireccionado a Mercado Pago para realizar el pago y terminar la compra. Incorpora todo los medios de pagos disponibles en el país e incluye la posibilidad de pagar con el dinero en la cuenta de Mercado Pago.

Para crear esta condición de pago, sigue estos pasos:

  1. En el panel de administración, ingresa en Configuraciones de medios de pago.
  2. En la pestaña Condiciones de pago, haz clic en +.
  3. En la sección Otro, elige como condición de pago Mercado Pago.
  4. Nombra la regla para ayudar facilitar la identificación y activa la condición en el campo Status.
  5. En el campo Proceso con la afiliación, elige como afiliación a MercadoPagoV1.
  6. Haz clic en Guardar.

Imagen cow

Configuración de medios de pago Mercado Pago Pro

El comprador finalizará el pago en Mercado Pago a través del formulario web modo modal directamente en tu sitio.

Para crear esta condición de pago, sigue estos pasos:

  1. En el panel de administración, ingresa en Configuraciones de medios de pago.
  2. En la pestaña Condiciones de pago, haz clic en +.
  3. En la sección Otro, elige como condición de pago MercadoPagoPro.
  4. Nombra la regla para ayudar facilitar la identificación y activa la condición en el campo Status.
  5. En el campo Proceso con la afiliación, elige como afiliación a MercadoPagoV1.
  6. Haz clic en Guardar.

Imagen cow

Configuración de medios de pago Mercado Pago Wallet

El comprador finalizará el pago con la billetera de Mercado Pago exclusivamente para usuarios registrados y al terminar el proceso volverá a tu sitio.

Para crear esta condición de pago, sigue estos pasos:

  1. En el panel de administración, ingresa en Configuraciones de medios de pago.
  2. En la pestaña Condiciones de pago, haz clic en +.
  3. En la sección Otro, elige como condición de pago MercadoPagoWallet.
  4. Nombra la regla para ayudar a facilitar la identificación y activa la condición en el campo Status.
  5. En el campo Proceso con la afiliación, elige como afiliación a MercadoPagoV1.
  6. Haz clic en Guardar.

Imagen cow

Importante
Si las condiciones de pago de MercadoPagoPro y MercadoPagoWallet no están disponibles para agregarlas, asegúrate de que en tu tienda de aplicaciones en VTEX esté instalada la App de Mercado Pago Payments APP o solicita la instalación al equipo de VTEX a través de un ticket en Soporte VTEX.
Nota
Los cambios en las Condiciones de pago pueden demorar hasta 10 minutos en aplicarse.

Configura las cuotas sin interés en tu cuenta de Mercado Pago

  1. Ingresa a tu cuenta de Mercado Pago y ve a Tu negocio.
  2. Accede en la opción Configuraciones, navega hasta Ofrecer cuotas sin interés y haz clic en Activar.
  3. Elige ¿Cuántas quieres ofrecer? y confirma los cambios con el botón Activar.

Imagen cuotas

¡Y listo! Ya estás ofreciendo cuotas sin interés, con el costo de financiación que hayas configurado.

Obtén una mejor aprobación enviando el device fingerprint

Mercado Pago tiene sus propias herramientas de prevención de fraude. Te recomendamos que envíes información sobre el comportamiento de tus clientes para detectar movimientos inusuales y evitar transacciones fraudulentas. Y no te preocupes, cuidamos los datos de tus clientes y no los compartiremos con nadie.

Para configurar el device fingerprint, sigue estos pasos:

  1. En el panel de administración, accede a tu Checkout desde el módulo en Configuraciones de la tienda.
  2. En la configuración de tu sitio, haz clic en Editar.
  3. En la pestaña Código, ingresa a “checkout5-custom.js” o a “checkout6-custom.js” (dependiendo de la versión de Checkout de VTEX que estés usando) desde el módulo de archivos.
  4. Copia y pega el siguiente código y guarda los cambios.

javascript

var script = document.createElement("script");
script.src = "https://www.mercadopago.com/v2/security.js";
script.setAttribute("output","vtex.deviceFingerprint");
script.setAttribute("view","checkout");
document.body.appendChild(script);

Comprender los log de VTEX

Los logs permiten revisar la información que retorna Mercado Pago y VTEX expone para poder tener un mayor entendimiento de lo que ocurrió con una transacción. También en caso de realizar modificaciones o prender nuevos medios de pago, los logs nos dan la posibilidad de poder validar que todo está funcionando según lo previsto.

Por último, proveen un mayor entendimiento a los equipos comerciales para que puedan dar un mejor soporte y convertirse en una primer instancia de soporte.

Ingresa en las transacciones de VTEX y busca el LOG que contenga el status response y haz clic en Ver más.

Los datos más significativos son los siguientes:

CampoDatoDescripción
id10302316Número de transacción de Mercado Pago.
payment_method_idvisaMedio de pago.
payment_type_idcredit_cardMedio de pago.
statusauthorizedEstado del pago.
status_detailpending_captureDetalle del estado de pago.
external_reference503451Identificador de VTEX enviado a Mercado Pago.
first_six_digits450995Bin de la tarjeta.
processing_modeagregadorModo de procesamiento del pago.

Para conocer el detalle sobre un pago rechazado, revisa el status_detail y busca la información en los manejos de respuesta de error.

Errores comunes

Los errores más comunes son los siguientes:

MensajeSignificado
unauthorized_use_of_live_credentialsLas credenciales de la cuenta de Mercado Pago no están habilitadas. Tienes que ir a la página de credenciales y activarlas.
invalid installmentsSe está intentando procesar el pago con una cuota que no está habilitada. Se debe ir a la configuración del medio de pago y definir las cuotas como Automáticas.
invalid_usersSe está intentando pagar con el mismo usuario que se está cobrando. Volver a intentar el pago con un mail pagador distinto.
Cannot infer Payment MethodSe quiere pagar con una tarjeta distinta al tipo de tarjeta seleccionado. Por ejemplo, se ingresó el número de una tarjeta de crédito en la opción de tarjeta de débito.
Para más información, visita el sitio oficial de VTEX y el sitio de Status de Vtex.
¿Te resultó útil esta información?

Copyright © 1999-2021 DeRemate.com de Uruguay S.R.L.

Términos y condicionesCómo cuidamos tu privacidad
Partners Mercado Pago

Al navegar en este sitio aceptas las cookies que utilizamos para mejorar tu experiencia. Más información.