InicioPago con QRPreciosSeguridadDevelopersBlog Ingresar Crear cuenta
Blog / Developers
Developers · 16 nov 2026 · 10 min de lectura · por TAYPI

Cómo integrar TAYPI en VTEX

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.

¿Por qué elegir una pasarela pagos VTEX Perú con QR interoperable?

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ú.

Qué es TAYPI y cómo funciona como pasarela de pagos QR 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:

  1. El comprador llega al checkout de tu tienda VTEX.
  2. Tu backend solicita a TAYPI un QR dinámico mediante la API REST.
  3. TAYPI devuelve un QR y un enlace de pago (checkout_url).
  4. El cliente escanea el QR desde su billetera y confirma el pago.
  5. TAYPI verifica la transacción directamente con la entidad financiera y te notifica por webhook.

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.

Requisitos previos para integrar TAYPI en VTEX

Antes de empezar con la parte técnica, asegúrate de cumplir con estos requisitos:

Cuenta de comercio verificada en TAYPI

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.

Acceso a las credenciales de API

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.

Conocimientos técnicos o un desarrollador

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.

Cómo conectar TAYPI en VTEX: pasos de integración

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:

Paso 1: Crea tu cuenta y obtén las credenciales

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.

Paso 2: Implementa el endpoint de pago en tu backend

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:

  • Monto fijo en soles (mínimo S/ 1.00).
  • Referencia de la orden (por ejemplo, el número de pedido de VTEX).
  • Datos del cliente (correo, teléfono, nombre).

TAYPI responde con un QR dinámico único y un checkout_url. Ambos deben mostrarse al cliente en el checkout.

Paso 3: Configura el checkout para mostrar el QR o el enlace

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.

Paso 4: Configura los webhooks para confirmar el pago

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:

  • Verifica la firma HMAC-SHA256 para asegurar que la notificación proviene de TAYPI.
  • Usa idempotencia para evitar cobros duplicados.
  • Actualiza el estado de la orden en VTEX (por ejemplo, marcarla como pagada).

Puedes consultar la guía completa sobre cómo verificar firmas HMAC-SHA256 en tu backend para mejorar la seguridad.

Paso 5: Realiza pruebas en sandbox

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.

Paso 6: Publica y monitorea

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.

Costos y comisiones de una pasarela pagos VTEX Perú

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:

  • Comisión variable: S/ 2.50
  • Comisión fija: S/ 0.20
  • IGV (18% sobre S/ 2.70): S/ 0.49
  • Total comisión: S/ 3.19
  • El comercio recibe: S/ 96.81

Además, TAYPI no cobra instalación, mensualidad ni permanencia. La activación es inmediata y solo pagas cuando hay un cobro confirmado.

Tabla comparativa: TAYPI vs pasarelas de tarjetas tradicionales

CaracterísticaTAYPI (QR interoperable)Pasarelas de tarjetas
Medios de pagoYape, Plin y billeteras interoperablesTarjetas de crédito/débito
Contracargos (chargebacks)No aplicaSí, riesgo presente
Verificación del pagoDirecta con la entidad financieraAutorización en línea
LiquidaciónDesde T+1 (día hábil siguiente)Variable según proveedor
Costo mensualSin mensualidadPuede incluir setup o mantenimiento
Monto mínimoS/ 1.00Generalmente no aplica
InstalaciónSin costoPuede tener costo de setup

Para ver el detalle completo de precios, visita precios de TAYPI.

Ventajas de usar QR interoperable en tu tienda VTEX

Cero contracargos y sin comisión de tarjetas

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.

Verificación bancaria directa

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.

Liquidación rápida y sin saldos atrapados

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.

Seguridad y cumplimiento en la integración

La seguridad es un pilar fundamental cuando hablamos de pagos digitales. TAYPI cumple con la normativa peruana y opera sobre infraestructura regulada.

Firmas HMAC-SHA256 e idempotencia

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.

Cumplimiento PLAFT y marco BCRP

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.

Preguntas frecuentes

¿TAYPI tiene un conector oficial para VTEX?

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.

¿Cuánto cuesta integrar TAYPI en 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.

¿Puedo aceptar tarjetas con TAYPI en mi tienda VTEX?

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.

¿Cuánto tarda la liquidación de los pagos QR?

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.

¿Necesito ser un experto técnico para integrar TAYPI en VTEX?

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.

Conclusión

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

¿Listo para cobrar con QR?

Crea tu cuenta gratis y genera tu primer QR en minutos.

Abrir cuenta gratis