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, transferencia bancaria 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.
Campos Datos necesarios
Nombre de afiliación Define el nombre que identificará a tu afiliación.
OAuth login No es necesario. Dejar como está.
PublicKey Refiere a las credenciales de tu cuenta de Mercado Pago. Completa con tu clave pública.
AccessToken Refiere a las credenciales de tu cuenta de Mercado Pago. Completa con tu clave privada.
RefreshToken Dejar en blanco.
ExpiredTokenIn Dejar en blanco.
Merchant Account Id Dejar en blanco.
Processing Mode Elige agregador como modo de procesamiento a partir de MercadoPagoV1.
CountryName Colombia.
SoftDescriptor Indica el nombre que va a aparecer para identificar una transacción de tu tienda en el resumen de la tarjeta del usuario.
Description Escribe una breve descripción de tu negocio (opcional).
CategoryId Elige la categoría de tus productos.
Financial Institution Dejar en blanco.
External Installments Elegir Yes / Sí. Usa las opciones de pago directamente de tu cuenta de Mercado Pago.
Antifraud Elegir Yes / Sí.
Time Zone Indica la región que define tu horario local.
OrderExpirationHours Elegir 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.
MaxInstallments Elige la cantidad de cuotas máximas que quieres ofrecer en Mercado pago.
Categoria Principal Selecciona la categoría correspondiente a su tienda.
Early Security Capture Puede 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

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 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, transferencia bancaria o medios de pago en efectivo. Como también, elegir la opción de recibir pagos directamente en el Checkout de Mercado Pago.

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. Transferencia bancaria (PSE)
  3. Efectivo


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 por transferencia bancaria

Para crear una condición de pago con PSE, 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 débito, elige el medio de pago que quieras agregar. Se deben agregar Débito online.
  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.

El medio de pago tarjeta Codensa no está disponible para el Checkout de VTEX.

Imagen transferencia


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 pago Medio de pago
ticket Efecty
ticket Baloto

Imagen efectivo

Condición de pagos con Checkout de 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

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:

Campo Dato Descripción
id 10302316 Número de transacción de Mercado Pago.
payment_method_id visa Medio de pago.
payment_type_id credit_card Medio de pago.
status authorized Estado del pago.
status_detail pending_capture Detalle del estado de pago.
external_reference 503451 Identificador de VTEX enviado a Mercado Pago.
first_six_digits 450995 Bin de la tarjeta.
processing_mode agregador Modo 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:

Mensaje Significado
unauthorized_use_of_live_credentials Las credenciales de la cuenta de Mercado Pago no están habilitadas. Tienes que ir a la página de credenciales y activarlas.
invalid installments Se 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_users Se está intentando pagar con el mismo usuario que se está cobrando. Volver a intentar el pago con un mail pagador distinto
Cannot infer Payment Method Se 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.

La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.