Integración
Sigue estos pasos para integrar izipay en VTEX de forma sencilla. Configura el proveedor de pago, activa la condición de pago y realiza pruebas para validar la integración. Una vez confirmado el correcto funcionamiento, cambia las credenciales a producción y completa el proceso.
Paso 1: Activación de Condición de pago
- Accede al panel administrativo de VTEX
- Navega a la sección de "Configuración de la tienda" >> "Pago"
- Selecciona "Configuración" y haz clic en el botón "+"
(*) Abrir imagen para más detalles.
- Busca y selecciona "izipay"
(*) Abrir imagen para más detalles.
- Activa la condición en el campo Status
(*) Abrir imagen para más detalles.
- Da clic en guardar para finalizar
(*) Abrir imagen para más detalles.
Paso 2: Instalación de Plugin en Vtex
- Ingresa al siguiente enlace colocando el nombre de tu comercio:
https://{{accountName}}.myvtex.com/admin/apps/izipaypartnerpe.izipay-payment-checkout@2.0.11/setup/ - Instala la extensión "Checkout Izipay" para poder utilizar la visualización "Pop-up
(*) Abrir imagen para más detalles.
- Accede al panel administrativo de VTEX
- Navega a la sección de "Configuración de la tienda" >> "Pago"
- Selecciona "Proveedores"
(*) Abrir imagen para más detalles.
- Haz clic en "Nuevo Proveedor"
(*) Abrir imagen para más detalles.
- Digita "izipay" y selecciona
(*) Abrir imagen para más detalles.
- Completa con credenciales proporcionadas por izipay y guarda los datos
(*) Abrir imagen para más detalles.
- A continuación te brindamos mayor detalle de los campos solicitados:
| Campo | Descripción | Ejemplo |
|---|---|---|
| Application key | Llave del comercio de Prueba o Producción | |
| Application token | Token del comercio de Prueba o Producción | |
| Pay method | Métodos de pagos que ofrecerá a sus compradores. Los métodos de pago disponibles de izipay son Tarjeta, QR y Yape. | CARD QR YAPE_CODE CARD,QR,YAPE_CODE |
| Url notification | Opcional. URL de su servicio API que recepcionará la notificación de pago (IPN). | https://mydomain.com/apis/receptions |
| Language | Opcional. Idioma de la pasarela de pago, solo permitido idioma inglés y español. Por defecto en español. | ENG ESP |
| Logo | Opcional. URL del logo de su comercio. Por defecto sin logo. | https://mydomain.com/public/my-logo.png |
| BackgroundColor | Opcional. Color de los botones del formulario, componentes y selectores.El color debe estaren hexadecimal. Por defecto color verde. | #562c16 |
| TextColor | Opcional. Color de los textos del formulario. El color debe estar en hexadecimal. Por defecto color negro | #ffffff |
| Liquidación automática | Permite configurar la modalidad de liquidación. Recomendamos seleccionar uso recomendado del procesador. En caso se requiera una configuración personalizada de depósito consultar aquí. | "Utilizar comportamiento recomendado por el procesador de pagos" |
| Modalidad | Permite seleccionar la forma de cómo se visualizará el formulario de pago. | Pop-up Redirect |
Paso 3: Pruebas y Validación (modo de prueba)
- Marca la opción de "Modo de Prueba" en el detalle del proveedor y guarda la configuración.
(*) Abrir imagen para más detalles.
- Te brindamos tarjetas para realizar pruebas (configuración en modo de prueba)
| Tarjeta | Número de tarjeta | Fecha de caducidad | Código de seguridad |
|---|---|---|---|
| VISA | 4970100000000055 | 12/2025 | 123 |
| MASTERCARD | 5100010000002045 | 12/2025 | 123 |
| AMERICAN EXPRESS | 378282000000008 | 12/2025 | 123 |
| DINERS CLUB | 36100690002635 | 12/25 | 111 |
- Visita tu comercio WEB como comprador
- Simula una compra hasta llegar al checkout. Finaliza la compra para visualizar el formulario de pago
(*) Abrir imagen para más detalles.
- Completa la compra con una de las tarjetas de prueba brindadas (modo de prueba)
(*) Abrir imagen para más detalles.
- Valida el pago exitoso
(*) Abrir imagen para más detalles.
- Revisa la compra en el gestor de pedidos de VTEX
(*) Abrir imagen para más detalles.
Paso 4: Pase a Producción
- Ingresa a la configuración del conector de pago izipay
(*) Abrir imagen para más detalles.
- Actualiza los campos App key y App token con las credenciales de tu comercio Izipay producción. Luego desmarca la opción de "Modo de Prueba" y guarda la configuración.
(*) Abrir imagen para más detalles.
- Realiza una compra de prueba en producción
- ¡Listo! Tu integración está completa y funcionando