Pagos con tarjeta
Para ofrecer pagos con tarjetas y procesar el cobro a través de Mercado Pago, deberás configurar cada bandera de tarjeta de crédito que desees ofrecer y luego seleccionar a Mercado Pago como proveedor de procesamiento. A continuación, te explicaremos cómo realizar esta configuración.
-
En el menú lateral, selecciona Configuración de la tienda > Pagos > Configuración.
-
En la pestaña Condiciones de pago, haz clic en el botón con el símbolo + en la esquina superior derecha de la pantalla para agregar un nuevo medio de pago.

- Busca la categoría Tarjeta de crédito y selecciona la bandera que deseas configurar.

-
Completa los campos necesarios:
- Nombre de la Condición: elige un nombre que te permita identificar este medio de pago y haz clic en la tilde ubicada a la derecha para guardarlo.
- Status: activa el medio de pago utilizando el botón deslizante.
- Procesar con proveedor: selecciona MercadoPagoV2.
-
Selecciona la opción Al contado.
-
Opcionalmente, puedes agregar requisitos especiales haciendo clic en el botón Agregar condición especial.
- Fecha de vencimiento: Permite limitar la actividad del medio de pago sólo por períodos de fechas o establecer una recurrencia.
- Emisor de la tarjeta: Permite limitar la actividad del medio de pago según el país y banco emisor de la tarjeta.
- Política comercial (Canal de ventas): Disponibiliza una condición de pago únicamente para una o varias políticas comerciales específicas.
- Condición comercial: Crea reglas que se aplican a grupos específicos de SKUs y determina criterios para que un medio de pago aparezca en el checkout de la tienda.
- Nombre de la cuenta: Este campo solo debe ser completado en caso de tener más de una tienda registrada en una misma cuenta de VTEX. En esos casos, deberás seleccionar en qué tienda deseas configurar el medio de pago.
-
Haz clic en Guardar para activar la configuración.

-
En el menú lateral, selecciona Configuración de la tienda > Pagos > Configuración.
-
En la pestaña Condiciones de pago, haz clic en el botón con el símbolo + en la esquina superior derecha de la pantalla para agregar un nuevo medio de pago.

- Busca la categoría Tarjeta de crédito y selecciona la bandera que deseas configurar.

-
Completa los campos necesarios:
- Nombre de la Condición: elige un nombre que te permita identificar este medio de pago y haz clic en la tilde ubicada a la derecha para guardarlo.
- Status: activa el medio de pago utilizando el botón deslizante.
- Procesar con proveedor: selecciona MercadoPagoV2.
-
Selecciona la opción En cuotas y completa los campos necesarios:
- Número total de cuotas: Define el número de cuotas secuenciales (ej.: 1-12) o individuales (ej.: 1, 3, 6). Puedes ofrecer hasta 12 cuotas.
- Cuota mínima: Establece un valor monetario mínimo a partir del cual se ofrecerá esta opción de pago.
- Facturación: este campo sólo se tendrá en cuenta para las cuotas con interés, por lo que cualquier opción es válida.
El número de cuotas configurado en esta instancia tendrá prioridad por sobre las cuotas máximas indicadas durante la configuración del proveedor de pagos. Recomendamos indicar la misma cantidad para evitar inconsistencias.

- Haz clic en Guardar para activar la configuración.
Puedes configurar cuotas con intereses para los pagos con tarjeta de crédito y personalizar el porcentaje de interés para cada cuota. Para eso, primero deberás instalar la aplicación Mercado Pago installments connection y luego configurar los pagos en cuotas con interés para la bandera que desees ofrecer. Sigue los pasos a continuación.
Instalar Mercado Pago installments connection
Para asegurar que las condiciones de cuotas e intereses que estén configurados en VTEX coincidan con las que estén configuradas en Mercado Pago y evitar inconsistencias en la facturación, deberás configurar la aplicación Mercado Pago installments connection. Sigue los pasos a continuación para hacerlo.
- En el menú lateral, selecciona Apps > Hub de extensiones > App Store.
- En el buscador escribe Mercado Pago installments connection y selecciona la aplicación que aparecerá debajo.

- Haz clic en el botón Instalar. Aparecerá una ventana emergente en donde podrás leer los términos y condiciones. Si estás de acuerdo, confírmalo utilizando el botón Instalar.
- Haz clic en el botón Item # 0 para vincular la cuenta de Mercado Pago del vendedor con la tienda de VTEX. 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 |
| API key | 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. |
| API Token | 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 Payment Methods, desmarca las banderas de tarjetas de crédito que no corresponden al país en donde opera la tienda de VTEX.

- Finalmente, en la ventana siguiente, haz clic en Guardar para terminar la instalación.
Agregar pagos con tarjeta de crédito con cuotas con interés
-
En el menú lateral, selecciona Configuración de la tienda > Pagos > Configuración.
-
En la pestaña Condiciones de pago, haz clic en el botón con el símbolo + en la esquina superior derecha de la pantalla para agregar un nuevo medio de pago.

- Busca la categoría Tarjeta de crédito y selecciona la bandera que deseas configurar.

-
Completa los campos necesarios:
- Nombre de la Condición: elige un nombre que te permita identificar este medio de pago y haz clic en la tilde ubicada a la derecha para guardarlo.
- Status: activa el medio de pago utilizando el botón deslizante.
- Procesar con proveedor: selecciona MercadoPagoV2.
-
Selecciona la opción En cuotas y completa los campos necesarios:
- Número total de cuotas: Define el número de cuotas secuenciales (ej.: 1-12) o individuales (ej.: 1, 3, 6). Puedes ofrecer hasta 12 cuotas.
- Cuota mínima: Establece un valor monetario mínimo a partir del cual se ofrecerá esta opción de pago.
- Facturación: este campo sólo se tendrá en cuenta para las cuotas con interés, por lo que cualquier opción es válida.
El número de cuotas configurado en esta instancia tendrá prioridad por sobre las cuotas máximas indicadas durante la configuración del proveedor de pagos. Recomendamos indicar la misma cantidad para evitar inconsistencias. -
Luego, haz clic en el botón Establecer tasa de interés. Las tasas de interés se configurarán de forma automática con las que tengas establecidas en tu cuenta de Mercado Pago.
-
Haz clic en Guardar para activar la configuración.

-
En el menú lateral, selecciona Configuración de la tienda > Pagos > Configuración.
-
En la pestaña Condiciones de pago, haz clic en el botón con el símbolo + en la esquina superior derecha de la pantalla para agregar un nuevo medio de pago.

- Busca la categoría Tarjeta de crédito y selecciona la bandera que deseas configurar.

-
Completa los campos necesarios:
- Nombre de la Condición: elige un nombre que te permita identificar este medio de pago y haz clic en la tilde ubicada a la derecha para guardarlo.
- Status: activa el medio de pago utilizando el botón deslizante.
- Procesar con proveedor: selecciona MercadoPagoV2.
-
Selecciona la opción Al contado.
-
Opcionalmente, puedes agregar requisitos especiales haciendo clic en el botón Agregar condición especial.
- Fecha de vencimiento: Permite limitar la actividad del medio de pago sólo por períodos de fechas o establecer una recurrencia.
- Emisor de la tarjeta: Permite limitar la actividad del medio de pago según el país y banco emisor de la tarjeta.
- Política comercial (Canal de ventas): Disponibiliza una condición de pago únicamente para una o varias políticas comerciales específicas.
- Condición comercial: Crea reglas que se aplican a grupos específicos de SKUs y determina criterios para que un medio de pago aparezca en el checkout de la tienda.
- Nombre de la cuenta: Este campo solo debe ser completado en caso de tener más de una tienda registrada en una misma cuenta de VTEX. En esos casos, deberás seleccionar en qué tienda deseas configurar el medio de pago.
-
Haz clic en Guardar para activar la configuración.
