Cómo integrar TAYPI en VTEX
Pasos para conectar TAYPI como medio de pago QR en una tienda VTEX en Perú.
Pasos para conectar TAYPI como medio de pago QR en una tienda VTEX en Perú.
Integrar una pasarela pagos VTEX Perú con QR interoperable es una decisión estratégica para reducir fricciones, eliminar las capturas falsas y cobrar sin necesidad de tarjetas. En esta guía te explico cómo conectar TAYPI como medio de pago QR en una tienda VTEX, incluso sin que exista un conector oficial. Descubrirás los pasos técnicos, los costos reales y las ventajas de esta integración.
VTEX es una de las plataformas de e-commerce más utilizadas en Latinoamérica, pero su ecosistema de pagos suele girar en torno a tarjetas de crédito o débito. Eso deja fuera a miles de compradores peruanos que prefieren pagar con Yape, Plin o cualquier billetera interoperable desde su celular.
Aquí es donde entra una pasarela de pagos VTEX Perú basada en QR. A diferencia de las pasarelas tradicionales, no dependes de que el cliente ingrese un número de tarjeta. Solo escanea un QR, confirma el monto y el pago se verifica directamente con la entidad financiera. Eso elimina los chargebacks por fraude, reduce la validación manual y acelera la confirmación de la orden.
Además, el QR interoperable funciona bajo la infraestructura de la Cámara de Compensación Electrónica (CCE) del BCRP, lo que garantiza que cualquier billetera conectada pueda pagar. Para tiendas VTEX en Perú, esto representa una oportunidad real de aumentar la conversión en el checkout, sobre todo en segmentos de ticket bajo y medio.
Si quieres profundizar en este ecosistema, te recomiendo leer qué son los pagos QR interoperables en Perú.
TAYPI es una pasarela de pagos con QR interoperable para e-commerce y comercios en Perú. Está operada por NEO TECHNOLOGY PERÚ E.I.R.L. (NEOTec) y permite cobrar con QR dinámico único, monto fijo y referencia, que expira en 15 minutos.
A diferencia de otros procesadores, TAYPI no procesa tarjetas de crédito o débito. Su foco está en billeteras y QR interoperable peruano. Eso significa que, si integras TAYPI en tu tienda VTEX, ofrecerás a tus clientes la opción de pagar con Yape, Plin y cualquier billetera conectada a la interoperabilidad del BCRP.
El proceso es simple:
checkout_url).No hay capturas de pantalla ni confirmación manual: si TAYPI confirma el pago, está pagado. Además, cada cobro queda asociado a una referencia, lo que facilita la conciliación automática.
Antes de empezar con la parte técnica, asegúrate de cumplir con estos requisitos:
Necesitas una cuenta activa en TAYPI y completar la verificación de comercio Nivel 2 (KYB), que incluye la validación de tu empresa. El registro es gratuito y puedes crear tu cuenta en el panel de TAYPI. La activación es inmediata, sin costo de instalación ni mensualidad.
Desde el panel de TAYPI obtendrás las claves de sandbox y producción. La integración usa autenticación con firma HMAC-SHA256, por lo que debes guardar estas claves de forma segura. También tendrás acceso a la documentación oficial para developers, que incluye ejemplos de llamadas a la API REST.
TAYPI no tiene conector oficial para VTEX. Los plugins oficiales son solo para WooCommerce y WHMCS. Para integrarlo en VTEX, necesitarás desarrollar un conector personalizado que hable con la API REST de TAYPI y con las APIs de pagos de VTEX. Si no tienes un equipo técnico interno, puedes contratar a un desarrollador con experiencia en VTEX.
La integración se realiza mediante la API REST de TAYPI y webhooks en tiempo real. No existe un conector nativo, así que el flujo requiere un desarrollo a medida. Aquí tienes los pasos generales:
Regístrate en app.taypi.pe y completa la verificación de comercio Nivel 2. Luego, desde el panel, genera tus claves de sandbox para pruebas y las de producción cuando estés listo.
Tu backend (puede estar en VTEX IO o en un servidor externo) debe llamar a POST /api/v1/payments de TAYPI. Esta llamada debe incluir:
TAYPI responde con un QR dinámico único y un checkout_url. Ambos deben mostrarse al cliente en el checkout.
En la pantalla de pago de tu tienda, muestra el QR generado y, opcionalmente, el botón para abrir el enlace de pago. El QR expira en 15 minutos, así que debes generarlo justo en el momento del checkout.
TAYPI envía notificaciones en tiempo real mediante webhooks. Debes exponer una URL en tu backend para recibir eventos como payment.confirmed o payment.expired. Al recibir un webhook:
Puedes consultar la guía completa sobre cómo verificar firmas HMAC-SHA256 en tu backend para mejorar la seguridad.
Antes de pasar a producción, prueba el flujo completo en el entorno de sandbox. Simula pagos aprobados, expirados y fallidos. Verifica que los webhooks se reciban correctamente y que la conciliación automática asocie cada cobro con su referencia.
Cuando todo funcione, cambia a las claves de producción y publica el conector. Puedes complementar la integración con otras herramientas de TAYPI como Checkout.js, que acelera la implementación del front de pagos. Revisa la documentación para developers de TAYPI para integrar más capacidades.
Uno de los factores que más influye al elegir una pasarela es el costo por transacción. En el caso de TAYPI, la comisión es transparente:
Comisión: 2.50% + S/ 0.20 + IGV por cobro confirmado.
El IGV (18%) se aplica sobre la comisión. La fórmula es:
(monto × 2.50% + número_de_cobros × S/ 0.20) × 1.18
Ejemplo con un cobro de S/ 100:
Además, TAYPI no cobra instalación, mensualidad ni permanencia. La activación es inmediata y solo pagas cuando hay un cobro confirmado.
| Característica | TAYPI (QR interoperable) | Pasarelas de tarjetas |
|---|---|---|
| Medios de pago | Yape, Plin y billeteras interoperables | Tarjetas de crédito/débito |
| Contracargos (chargebacks) | No aplica | Sí, riesgo presente |
| Verificación del pago | Directa con la entidad financiera | Autorización en línea |
| Liquidación | Desde T+1 (día hábil siguiente) | Variable según proveedor |
| Costo mensual | Sin mensualidad | Puede incluir setup o mantenimiento |
| Monto mínimo | S/ 1.00 | Generalmente no aplica |
| Instalación | Sin costo | Puede tener costo de setup |
Para ver el detalle completo de precios, visita precios de TAYPI.
Al no procesar tarjetas, eliminas por completo el riesgo de chargebacks. Los pagos con billetera se confirman en tiempo real y no hay devoluciones forzadas por fraude. Esto reduce costos operativos y dolores de cabeza.
TAYPI verifica cada pago directamente con la entidad financiera. No dependes de capturas de pantalla ni de validación manual. Si el webhook dice que el pago está confirmado, puedes liberar la orden con total confianza.
El dinero se deposita a tu cuenta bancaria (CCI) desde el día hábil siguiente (T+1). Si el saldo no alcanza el depósito mínimo, se acumula sin cargo y se deposita al alcanzarlo o el último día hábil del mes. No hay saldos retenidos en una app. Para plazos y montos exactos, consulta los términos y condiciones de TAYPI.
La seguridad es un pilar fundamental cuando hablamos de pagos digitales. TAYPI cumple con la normativa peruana y opera sobre infraestructura regulada.
La autenticación de la API se realiza mediante firma HMAC-SHA256, lo que garantiza que las solicitudes provienen de fuentes legítimas. Además, la idempotencia evita que un reintento de pago duplique un cobro. Todo el tráfico viaja cifrado con TLS 1.3.
TAYPI cumple con la prevención de lavado de activos (PLAFT), conforme a la normativa peruana de la SBS y la UIF-Perú. Opera sobre la infraestructura de pagos interoperables del BCRP (vía CCE), bajo el marco del sistema financiero supervisado por la SBS, a través de su procesador, una EEDE regulada. Además, cuenta con certificaciones ISO 27001:2022 e ISO 9001:2015.
Para más detalles, revisa la información de seguridad de TAYPI.
No. TAYPI no ofrece un conector o app oficial para VTEX. La integración se realiza mediante su API REST y webhooks, desarrollando un conector personalizado en tu tienda VTEX.
No hay costo de instalación, mensualidad ni permanencia. Solo pagas la comisión por cada cobro confirmado: 2.50% + S/ 0.20 + IGV. El desarrollo del conector puede requerir inversión técnica si no tienes un equipo interno.
No. TAYPI solo procesa pagos con QR interoperable: Yape, Plin y cualquier billetera conectada a la CCE del BCRP. No procesa tarjetas de crédito o débito. Si necesitas tarjetas, deberías complementar con otra pasarela.
La liquidación se realiza desde T+1, es decir, desde el día hábil siguiente a la confirmación del pago. Si el saldo no alcanza el depósito mínimo, se acumula sin cargo hasta alcanzarlo o el último día hábil del mes.
Sí, se requieren conocimientos de desarrollo para implementar la API REST y los webhooks. TAYPI ofrece SDKs oficiales en PHP, JavaScript/TypeScript y .NET, además de una documentación detallada. Si no tienes equipo técnico, puedes contratar a un desarrollador con experiencia en VTEX.
Integrar una pasarela pagos VTEX Perú basada en QR interoperable es una excelente forma de ampliar tus medios de pago sin depender de tarjetas. Con TAYPI, puedes ofrecer a tus clientes la posibilidad de pagar con Yape, Plin y cualquier billetera interoperable, con verificación bancaria directa, cero contracargos y liquidación desde el día hábil siguiente.
Aunque no exista un conector oficial para VTEX, la integración mediante API REST y webhooks es totalmente viable para un equipo técnico con experiencia. Los costos son competitivos y la activación es inmediata.
Si buscas una alternativa sin mensualidades ni costos ocultos, crea tu cuenta gratis en TAYPI y comienza a probar en sandbox. Tu tienda VTEX puede estar lista para cobrar con QR en poco tiempo, mejorando la conversión y reduciendo la fricción en el checkout.
¿Listo para dar el siguiente paso? Conoce más sobre TAYPI y sus funcionalidades para comercios en taypi.pe o explora su [p
Crea tu cuenta gratis y genera tu primer QR en minutos.
Abrir cuenta gratis