En VTEX puedes realizar la integración con el proveedor de pago StripeV2. A través de este proveedor, tu tienda puede ofrecer diversos medios de pago, como Visa, American Express, Diners, Elo, Hipercard, Mastercard, BankInvoice, Stripe, Google Pay, ApplePay, OXXO, Discover, Affirm, Klarna, ZIP, Blik, Ideal, SPEI, MultiBanco, Afterpay, Bancontact, EPS, FPX, giropay y P24.
Para más información sobre la integración de VTEX con Stripe, también puede acceder a la documentación de Vinneren.
Opciones de operación
El proveedor StripeV2 puede procesar transacciones de pago en tiendas VTEX de dos maneras diferentes:
-
VTEX Native Checkout Experience: puede usarse para tarjetas de crédito, tarjetas de débito y medios de pago desarrollados con Payment Provider Framework (PPF). Esta opción es recomendable si deseas configurar otros gateways de pago para diferentes redes de tarjeta o realizar transacciones utilizando el checkout nativo de VTEX.
-
VTEX with Stripe Payment Element Experience: aplicación de pago basada en el Stripe’s Optimized Checkout Suite (OCS). Esta opción se recomienda si deseas utilizar Stripe exclusivamente para procesar todas las redes de tarjetas o para acceder a Stripe Link, una solución que ofrece acceso rápido a varios medios de pago con un solo clic.
VTEX with Stripe Payment Element Experience utiliza el Stripe Payment Elements Checkout, proporcionando acceso a los medios de pago actuales y futuros admitidos por Stripe. En esta opción, la configuración de los medios de pago se debe realizar directamente en Stripe Dashboard.
Después de determinar la opción con la que deseas operar en tu tienda, sigue las instrucciones del procedimiento correspondiente a continuación:
La configuración realizada en un entorno externo a VTEX puede descontinuarse o modificarse sin previo aviso. Consulta tu cuenta en Stripe para información actualizada.
Configurar VTEX Native Checkout Experience
El equipo de Stripe debe habilitar los pagos de RawPan en su cuenta. Comuníquese con su Stripe advisor. Si esta opción no está habilitada en su cuenta, no podrá realizar transacciones exitosas.
Requisitos previos:
- Usuario VTEX con permisos de administrador
- Cuenta activa de Stripe
Para utilizar VTEX Native Checkout Experience en tu tienda, es necesario:
Instalar las aplicaciones de Stripe
Para instalar las aplicaciones de Stripe en tu tienda, sigue los pasos a continuación:
Configurar StripeV2 en VTEX
Para configurar la integración de StripeV2 en VTEX sigue los pasos a continuación:
- En el Admin VTEX, accede a Configuración de la tienda > Pago > Proveedores, o ingresa Proveedores en la barra de búsqueda en la parte superior de la página.
- En la pantalla de proveedores, haz clic en el botón
Nuevo proveedor
. - Ingresa StripeV2 en la barra de búsqueda y haz clic en el nombre del proveedor.
- En Clave de aplicación, ingrese la clave publicable que obtuvo en los pasos anteriores.
- En Token de aplicación, ingrese la clave secreta que obtuvo en los pasos anteriores.
- En Información general, en la opción Nombre, ingrese StripeV2NativeCheckout para identificar el tipo de integración.
- En Campos del proveedor, en la opción Mode, selecciona Float.
- En Test Mode, seleccione Falso si el modo es Live o True si el modo es Test.
- Haz clic en
Guardar
.
Configurar script antifraude
Para configurar el script antifraude para StripeV2 en VTEX, siga los pasos a continuación:
- Copia el script disponible en la sección "Integrate script into your VTEX store".
- En el Admin de VTEX, acceda a Configuración de la tienda > Storefront > Checkout > Código.
- Haga clic en el botón Nuevo e ingrese un nombre descriptivo.
- Pegue el contenido del script que copió anteriormente.
- Reemplace la información "pk_test" con su clave pública de Stripe copiada en los pasos anteriores.
- Haga clic en
Guardar
.
Configurar condición de pago
Para configurar una condición de pago para StripeV2 en VTEX sigue los pasos a continuación:
- En el Admin VTEX, accede a Configuración de la tienda > Pago > Configuración, o ingresa Configuración en la barra de búsqueda en la parte superior de la página.
- En la pestaña Condiciones de pago, haz clic en el botón
+
. - Haz clic sobre el nuevo medio de pago que desees utilizar.
- En la pantalla de configuración, activa la condición haciendo clic en Status.
- En Procesar con el proveedor, selecciona la opción StripeV2NativeCheckout.
- Si deseas utilizar un sistema antifraude, selecciona la opción Utilizar antifraude.
- Si lo deseas, también puedes configurar condiciones de pago especiales.
- Haz clic en
Guardar
.
Para más información sobre los procedimientos de instalación de VTEX Native Checkout Experience, accede a la documentación pública de Stripe en Vinneren.
Configurar VTEX con Stripe Payment Element Experience
Requisitos previos:
- Usuario VTEX con permisos de administrador
- Cuenta activa de Stripe
Para utilizar o VTEX with Stripe Payment Element Experience em sua loja, é necessário:
- Instalar las aplicaciones de Stripe
- Configurar StripeV2 en VTEX
- Configurar condiciones de pago
- Configurar un webhook en la cuenta Stripe
Instalar las aplicaciones de Stripe
Para instalar las aplicaciones de Stripe en tu tienda sigue los pasos a continuación:
Configurar StripeV2 en VTEX
Para configurar la integración de StripeV2 en VTEX sigue los pasos a continuación:
- En el Admin VTEX, accede a Configuración de la tienda > Pago > Proveedores, o ingresa Proveedores en la barra de búsqueda en la parte superior de la página.
- En la pantalla de proveedores, haz clic en el botón
Nuevo proveedor
. - Ingresa StripeV2 en la barra de búsqueda y haz clic sobre el nombre del proveedor.
- En Clave de aplicación, ingresa la clave publicable que obtuviste en el VTEX Elements Checkout (Stripe App).
- En Token de aplicación, ingresa la clave secreta que obtuviste en el VTEX Elements Checkout (Stripe App) (restricted API key).
- En Información general, en la opción Nombre, ingrese StripeV2Elements para identificar el tipo de integración.
- En Campos del proveedor, en la opción Mode, selecciona Embedded.
- En Test Mode, seleccione Falso si el modo es Live o True si el modo es Test.
- Haz clic en
Guardar
. - Agregue claves Stripe en la configuración de la aplicación del proveedor, de la siguiente manera:
Configurar condición de pago
Para configurar una condición de pago para StripeV2 en VTEX sigue los pasos a continuación:
- En el Admin VTEX, accede a Configuración de la tienda > Pago > Configuración, o ingresa Configuración en la barra de búsqueda en la parte superior de la página.
- En la pestaña Condiciones de pago, haz clic en el botón
+
. - Haz clic sobre el nuevo medio de pago que desees utilizar.
- En la pantalla de configuración, activa la condición haciendo clic en Status.
- En Procesar con proveedor, selecciona la opción StripeV2Elements.
- Si deseas utilizar un sistema antifraude, selecciona la opción Utilizar antifraude.
- Si lo deseas, también puedes configurar condiciones de pago especiales.
- Haz clic en
Guardar
.
Para más información sobre los procedimientos de instalación de VTEX with Stripe Payment Element Experience, accede a la documentación pública de Stripe en Vinneren.
Configurar un webhook en la cuenta Stripe
Para realizar la configuración del webhook en tu cuenta Stripe, sigue los pasos a continuación:
- Accede al dashboard de tu cuenta Stripe.
- Haz clic en el botón Developers.
- Haz clic en la pestaña Webhooks.
- Haz clic en el botón Add a connection point.
- En el campo Connection point URL, ingresa la URL del endpoint de tu tienda VTEX en el siguiente formato:
https://{{account}}.myvtex.com/_v/stripe.payment-provider-connector/v0/webhook
. Sustituye {account} por el nombre de tu cuenta VTEX. - Haz clic en + Select events.
- Haz clic en las categorías y selecciona los siguientes eventos:
- Haz clic en Add events.
- Haz clic en Add Connection Point.
Configurar pago con Google Pay en StripeV2 (opcional)
Con el proveedor StripeV2 puedes procesar pagos con Google Pay en tu tienda. Para configurar Google Pay sigue los pasos a continuación:
- Si ya completó los pasos de instalación de VTEX Elements, continúe con el Paso 13.
- Instale el VTEX Elements Checkout (Stripe App) para obtener las claves de Stripe necesarias.
- Una vez que se complete la instalación, se mostrarán las claves pública (pk) y restringida (rk). Cópielos y guárdelos, ya que los utilizará más adelante.
- En el Admin VTEX, accede a Configuración de la tienda > Pago > Proveedores, o ingresa Proveedores en la barra de búsqueda en la parte superior de la página.
- En la pantalla de proveedores, haz clic en el botón
Nuevo proveedor
. - Ingresa StripeV2 en la barra de búsqueda y haz clic sobre el nombre del proveedor.
- En Clave de aplicación, ingresa la clave publicable que obtuviste en el VTEX Elements Checkout (Stripe App).
- En Token de aplicación, ingresa la clave secreta que obtuviste en el VTEX Elements Checkout (Stripe App) (restricted API key).
- En Información general, en la opción Nombre, ingrese StripeV2Elements para identificar el tipo de integración.
- En Campos del proveedor, en la opción Mode, selecciona Embedded.
- En Test Mode, seleccione Falso si el modo es Live o True si el modo es Test.
- Haz clic en
Guardar
. - En el Admin VTEX, accede a Configuración de la tienda > Pago > Configuración, o ingresa Configuración en la barra de búsqueda en la parte superior de la página.
- En la pestaña Condiciones de pago, haz clic en el botón
+
. - Haz clic en la opción Google Pay.
- En la pantalla de configuración, activa la condición haciendo clic en Status.
- En Procesar con proveedor, selecciona la opción StripeV2Elements.
- Haz clic en
Guardar
.
Cuando hayas realizado estos pasos, Google Pay figurará en el checkout de la tienda como uno de los medios de pago disponibles.
Configurar pago con Apple Pay en StripeV2 (opcional)
Con el proveedor StripeV2 puedes procesar pagos con Apple Pay en tu tienda. Para configurar Apple Pay sigue los pasos a continuación:
- Si ya completó los pasos de instalación de VTEX Elements, continúe con el Paso 13.
- Instale el VTEX Elements Checkout (Stripe App) para obtener las claves de Stripe necesarias.
- Una vez que se complete la instalación, se mostrarán las claves pública (pk) y restringida (rk). Cópielos y guárdelos, ya que los utilizará más adelante.
- En el Admin VTEX, accede a Configuración de la tienda > Pago > Proveedores, o ingresa Proveedores en la barra de búsqueda en la parte superior de la página.
- En la pantalla de proveedores, haz clic en el botón
Nuevo proveedor
. - Ingresa StripeV2 en la barra de búsqueda y haz clic sobre el nombre del proveedor.
- En Clave de aplicación, ingresa la clave publicable que obtuviste en el VTEX Elements Checkout (Stripe App).
- En Token de aplicación, ingresa la clave secreta que obtuviste en el VTEX Elements Checkout (Stripe App) (restricted API key).
- En Información general, en la opción Nombre, ingrese StripeV2Elements para identificar el tipo de integración.
- En Campos del proveedor, en la opción Mode, selecciona Embedded.
- En Test Mode, seleccione Falso si el modo es Live o True si el modo es Test.
- Haz clic en
Guardar
. - Accede al dashboard de sua conta na Stripe en la sección de configuración de pagos.
- En Settings, haz clic en Payment Methods.
- Haz clic en Apple Pay > Set Up.
- Haz clic en Add to New Domain.
- Ingresa el dominio público del sitio web de tu tienda.
- Haz clic en Add.
- Ejecuta las acciones descritas en la documentación de Stripe y luego haz clic en Download the domain association file.
- Tras obtener el archivo, guarda la información y accede a la siguiente URL
https://{{account}}.myvtex.com/_v/stripe.paid-provider/v0/registerApplePay
. Sustituye {{account}} por el nombre de tu cuenta VTEX. - Ingresa la información previamente guardada en el campo Enter your Apple App Key.
- Haz clic en
Guardar
. - En el Admin VTEX, accede a Configuración de la tienda > Pago > Configuración, o ingresa Configuración en la barra de búsqueda en la parte superior de la página.
- En la pestaña Condiciones de pago, haz clic en el botón
+
. - Haz clic en Apple Pay.
- En la pantalla de configuración, activa la condición haciendo clic en Status.
- En Procesar con proveedor, selecciona la opción StripeV2.
- Si deseas utilizar un sistema antifraude, selecciona la opción Utilizar antifraude.
- Indique si desea procesar pagos con o sin cuotas.
- Si lo deseas, también puedes configurar condiciones de pago especiales.
- Haz clic en
Guardar
.
Cuando hayas realizado estos pasos, Apple Pay figurará en el checkout de la tienda como uno de los medios de pago disponibles.
Configurar condición de pago en meses sin intereses (MSI) (opcional)
La condición de pago en cuotas sin intereses (MSI - Meses Sin Intereses) está disponible en Stripe únicamente para cuentas en México.
MSI se puede configurar tanto la opción de operación VTEX Native Checkout experience como para VTEX with Stripe Payment Element Experience. A continuación se indican los pasos para configurarla en función de la opción de operación adoptada en tu tienda:
Configurar MSI en la opción VTEX Native Checkout experience
- Crea una cuenta Stripe en México configurada con la moneda MXN.
- En el Admin VTEX, accede a Configuración de la tienda > Pago > Configuración, o ingresa Configuración en la barra de búsqueda en la parte superior de la página.
- Haz clic en uno de los medios de pago disponibles que procesan pagos con MSI (tarjetas VISA, AMEX y Mastercard).
- Configura las condiciones MSI de la forma deseada en la pantalla del medio de pago.
- Configura las condiciones MSI en tu dashboard de Stripe con la misma información utilizada en la configuración de VTEX (paso 4).
Si la información registrada en los pasos 4 y 5 es diferente, la condición de MSI podría no funcionar correctamente.
Configurar MSI en la opción VTEX with Stripe Payment Element Experience
- Crea una cuenta Stripe en México configurada con la moneda MXN.
- Configura las condiciones de MSI en tu dashboard de Stripe.
- Ponte en contacto con tu representante de Stripe o con el equipo de Ayuda y soporte de Stripe para solicitar que esta condición de pago se active en tu tienda.