Configurar proveedor de pagos
La implementación con tiendas VTEX consta de dos pasos. Primero, deberás instalar Mercado Pago Payment App para garantizar la conciliación de todas tus transacciones entre ambas plataformas. Luego, deberás configurar a Mercado Pago como proveedor de pagos.
1. Instalar Mercado Pago Payment App
La instalación de Mercado Pago Payment App debe ser solicitada al Soporte de VTEX. Sigue los pasos a continuación para hacerlo.
- En el panel de administración de VTEX, ubicado en el lateral izquierdo, dirígete a Apps > Hub de extensiones > Gestión de aplicaciones.
- Haz clic en el signo de interrogación (“?”) de la parte superior derecha de la pantalla.
- Selecciona la opción Hable con nuestros expertos.
- Completa los campos solicitados con tu e-mail, nombre, e identificación de cuenta, y haz clic en Continue.
- Selecciona la opción Technical y solicita la instalación de Mercado Pago Payment App para la tienda.
A partir de este momento, concluirás la instalación de la aplicación con el Soporte de VTEX.
Una vez finalizado este proceso, deberás configurar la aplicación. Para esto, basta con acceder a Apps > Hub de extensiones > Gestión de aplicaciones, buscar la aplicación, y hacer clic en el botón Settings. Allí, deberás completar el campo Application Key con tu Public KeyClave pública de la aplicación, que es utilizada en el frontend para acceder a información y cifrar datos, sea en la etapa de desarrollo o en la de pruebas. y hacer clic en Guardar.
De esta forma, habrás finalizado tu instalación de Mercado Pago Payment App y podrás continuar con tus configuraciones.
2. Configurar a Mercado Pago como proveedor de pagos
Sigue los pasos a continuación para realizar la configuración.
- En el panel de administración de la plataforma VTEX, dirígete a Configuración de la tienda > Pago > Proveedores.
- En la parte superior de la pantalla, haz clic en el botón Nuevo proveedor para crear una afiliación con Mercado Pago.
- Utiliza el buscador para encontrar el conector MercadoPagoV2 y selecciónalo. Esto te llevará a una nueva pantalla.
- En esta pantalla, te serán solicitadas las credenciales de Mercado Pago para la Autorización del proveedor. Completa los campos según corresponda:
| Campo | Descripción |
| Clave de aplicación | Este campo hace referencia a la Public Key de la aplicación de Mercado Pago. Como estás en etapa de desarrollo, deberás utilizar la Public Key de la aplicación del usuario de pruebaClave pública de la aplicación del usuario de prueba, que es utilizada en el frontend para acceder a información y cifrar datos, sea en la etapa de desarrollo o en la de pruebas. Puedes acceder a ella iniciando sesión con tu usuario de pruebas y dirigiéndote a Tus integraciones > Detalles de aplicación > Producción > Credenciales de producción. Más adelante, podrás cambiarla por una productiva. |
| Token de aplicación | Este campo hace referencia al Access Token de la aplicación de Mercado Pago. Como estás en etapa de desarrollo, deberás utilizar el Access Token de la aplicación del usuario de pruebaClave privada de la aplicación del usuario de prueba, que es utilizada en el frontend para acceder a información y cifrar datos, sea en la etapa de desarrollo o en la de pruebas. Puedes acceder a ella iniciando sesión con tu usuario de pruebas y dirigiéndote a Tus integraciones > Detalles de aplicación > Producción > Credenciales de producción. Más adelante, podrás cambiarlo por uno productivo. |
- En la sección Información general, asígnale un nombre a la conexión con Mercado Pago. Este nombre será utilizado para que puedas identificar esta conexión dentro de la tienda.
- En Control de pagos, mantén desactivado el Modo de prueba para poder garantizar el correcto funcionamiento del flujo de pruebas más adelante.
- Luego, en el campo Liquidación automática, selecciona la opción Comportamiento recomendado por el procesador. De esta manera, VTEX respetará los plazos de captura que establezcas para Mercado Pago en próximos pasos, y podrás contar con la seguridad de nuestro control antifraudes.
- Completa los Campos del proveedor siguiendo las instrucciones a continuación.
Plazo, en días hábiles, para el vencimiento de la orden de compra. Si el cliente paga fuera de plazo, el dinero se depositará en su cuenta de Mercado Pago. Esta configuración tendrá efecto solo en caso de activar pagos en el ambiente de Mercado Pago con Checkout Pro y medios de pago offline.
Nombre de la tienda. El valor de este campo aparecerá en la factura de compra del cliente.
Número máximo de veces en las que podrá realizarse el pago. Con Mercado Pago, puedes ofrecer hasta 12 veces.
3-D Secure es un protocolo creado para proteger transacciones en comercios electrónicos mediante una capa adicional de verificación de identidad antes de la autorización final. Solo las transacciones rechazadas por alto riesgo se envían para la validación del 3DS y no afecta la experiencia de compra.
Para activarlo, deshabilita el Modo binário - binario y selecciona la opción Yes.
Rubro de la tienda.
Para ayudar a nuestro sistema de prevención de fraudes, tienes la opción de compartir los datos de la categoría de la tienda o producto por cada transacción realizada. Te recomendamos elegir la opción Categoria da Loja - Categoría de la Tienda.
En caso de cancelación, puedes elegir si deseas que Mercado Pago reembolse automáticamente el dinero, o si deseas retener el monto pagado para que el cliente lo use en futuras compras dentro de la misma tienda.
Configura si deseas que la tienda acepte pagos pendientes. Si seleccionas la opción No, la transacción quedará pendiente por 48 hs o hasta que se realice el pago, y el stock involucrado en esa compra será retenido por el mismo período de tiempo. Si seleccionas Sí, en cambio, se rechazarán transacciones pendientes y el stock será automáticamente liberado.
Recuerda que para usar 3DS, el modo binario precisa estar desactivado.
Permite excluir medios de pago para que no estén disponibles al momento de la compra. Excluir métodos y tipos de pago en esta etapa limitará esas opciones sólo en caso de implementar Pagos en el ambiente de Mercado Pago con Checkout Pro.
Deberás tipear los nombres de cada uno, tal como se muestra en Excluir tipos y medios de pago. Estarás excluyendo medios de pago en particular (visa, rapipago, amex, etc.)
También puedes excluir tipos de pago en su totalidad (credit_card; debit_card; ticket). Puedes mirar las opciones disponibles en Excluir tipos y medios de pago. Asegúrate de digitar los nombres tal cual están listados para garantizar que el proceso de exclusión sea correcto.
Excluir métodos y tipos de pago en esta etapa limitará esas opciones sólo en caso de implementar Pagos en el ambiente de Mercado Pago con Checkout Pro.
Selecciona la opción Aggregator, que es el modo en el que puedes procesar pagos con Mercado Pago.
Si eres desarrollador, completa con tu identificación de Mercado Pago.
Este campo identifica la moneda de la tienda. No es necesario que lo completes.
Cuenta del vendedor en donde se depositará el dinero de las ventas. No es necesario completar este campo.
Puedes configurar un retraso en la captura del pago que hace VTEX seleccionando de entre las opciones deplegables. Si no quieres configurarlo, selecciona Desactivado.
Configura el rango de tiempo que se deberá esperar para cancelar una compra no finalizada en el checkout. Puedes seleccionar un rango de tiempo entre las opciones desplegables, o bien elegir No cancelar.
Una vez que hayas completado todos los campos, haz clic en Guardar para completar tu conexión con Mercado Pago como proveedor de pagos.
Si llegas a experimentar algún problema durante estas configuraciones, puedes consultar nuestro Support Center.