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:
- Crea una cuenta de vendedor en Mercado Pago si aún no tiene una.
- Registra la afiliación con Mercado Pago.
- Configura las condiciones de pago.
- 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:
- Accede a las configuraciones del módulo en el panel de administración de tu tienda.
- En la pestaña de Afiliación de Gateway, haz clic en el botón +.
- Ingresa en el conector MercadoPagoV1.
- 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:
- Accede a las configuraciones del módulo en el panel de administración de tu tienda.
- En la pestaña de Afiliación de Gateway, haz clic en el botón +.
- Ingresa en el conector MercadoPagoV1.
- 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 | Uruguay. |
Bill due date in days | Dejar en 1. |
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. |
Mercado Pago 3P payment due date | Deshabilitado. |
3P payment due date after Mercado Pago expiration | Deshabilitado. |
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). |
¡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:
Condición de pagos para tarjeta de crédito
Para crear una condición de pagos con tarjeta de crédito, sigue estos pasos:
- En el panel de administración, ingresa en Configuraciones de medios de pago.
- En la pestaña Condiciones de pago, haz clic en +.
- 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.
- Nombra la regla para ayudar facilitar la identificación y activa la condición en el campo Status.
- En el campo Proceso con la afiliación, elige como afiliación a MercadoPagoV1.
- En la opción de cuotas, selecciona cuotas automáticas. Esto te permite usar la configuración de tu cuenta de Mercado Pago.
- Haz clic en Guardar.
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:
- En el panel de administración, ingresa en Configuraciones de medios de pago.
- En la pestaña Condiciones de pago, haz clic en +.
- En la sección Factura, elige Boleto bancario para agregar el medio de pago.
- Nombra la regla para ayudar facilitar la identificación y activa la condición en el campo Status.
- En el campo Proceso con la afiliación, elige como afiliación a MercadoPagoV1.
- 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 | Abitab |
ticket | Redpagos |
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:
- En el panel de administración, ingresa en Configuraciones de medios de pago.
- En la pestaña Pagos personalizados, busca la sección Cobrands y haz clic en Configurar.
- 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).
- Haz clic en Guardar.
- En la pestaña Planes de Pago, haz clic en +.
- En la sección Pago personalizado, elige el medio de pago que habías creado para agregar el medio de pago.
- Nombra la regla para ayudar facilitar la identificación y activa la condición en el campo Status.
- En el campo Proceso con la afiliación, elige como afiliación a MercadoPagoV1.
- Haz clic en Guardar.
En VTEX, los medios de pago personalizados que se pueden agregar son:
Tipo | Medio de pago | Bandera de la tarjeta | Bines | Código de pago del adquirente |
---|---|---|---|---|
credit_card | OCA | Mastercard | 589892, 542991, 549530, 549564, 549571, 549576 | oca |
credit_card | Creditel | Mastercard | 601933 | creditel |
credit_card | Lider | Mastercard | 501088,501109,505863,505866,505867,505868,505869,505870,505871,505872 | lider |
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:
- En el panel de administración, ingresa en Configuraciones de medios de pago.
- En la pestaña Condiciones de pago, haz clic en +.
- En la sección Otro, elige como condición de pago Mercado Pago.
- Nombra la regla para ayudar facilitar la identificación y activa la condición en el campo Status.
- En el campo Proceso con la afiliación, elige como afiliación a MercadoPagoV1.
- Haz clic en Guardar.
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:
- En el panel de administración, ingresa en Configuraciones de medios de pago.
- En la pestaña Condiciones de pago, haz clic en +.
- En la sección Otro, elige como condición de pago MercadoPagoPro.
- Nombra la regla para ayudar facilitar la identificación y activa la condición en el campo Status.
- En el campo Proceso con la afiliación, elige como afiliación a MercadoPagoV1.
- Haz clic en Guardar.
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:
- En el panel de administración, ingresa en Configuraciones de medios de pago.
- En la pestaña Condiciones de pago, haz clic en +.
- En la sección Otro, elige como condición de pago MercadoPagoWallet.
- Nombra la regla para ayudar a facilitar la identificación y activa la condición en el campo Status.
- En el campo Proceso con la afiliación, elige como afiliación a MercadoPagoV1.
- Haz clic en Guardar.
Configura las cuotas sin interés en tu cuenta de Mercado Pago
- Ingresa a tu cuenta de Mercado Pago y ve a Tu negocio.
- Accede en la opción Configuraciones, navega hasta Ofrecer cuotas sin interés y haz clic en Activar.
- Elige ¿Cuántas quieres ofrecer? y confirma los cambios con el botón Activar.
¡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:
- En el panel de administración, accede a tu Checkout desde el módulo en Configuraciones de la tienda.
- En la configuración de tu sitio, haz clic en Editar.
- 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.
- 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. |