¿Plugin o API? Cómo elegir la mejor forma de integrar TAYPI
Compara integrar por plugin, Checkout.js o API REST según tu plataforma, equipo y necesidades.
Compara integrar por plugin, Checkout.js o API REST según tu plataforma, equipo y necesidades.
Elegir entre plugin o API pasarela pagos define qué tan rápido integras, cuánto control tienes y cómo escalará tu checkout. Si vendes en Perú con TAYPI, no hablamos de una sola vía: puedes usar un plugin oficial, un checkout de bajo código o una API REST según tu plataforma y tu equipo. En esta guía comparamos las rutas reales de integración, con ventajas, límites y criterios para decidir sin improvisar.
Antes de decidir, conviene aclarar qué implica cada opción. Un plugin de pasarela de pagos es un módulo que instalas en tu plataforma de e-commerce o gestión, agrega el medio de pago y reduce la integración a tareas de configuración. En TAYPI, los plugins oficiales disponibles son para WooCommerce y WHMCS.
Una API de pagos es una interfaz de programación que te permite conectar tu propio sistema con la pasarela. TAYPI expone una API REST con endpoints como POST /api/v1/payments, que devuelve un QR dinámico y una URL de pago. Para acelerar el desarrollo, existen SDKs oficiales en PHP, JavaScript/TypeScript y .NET.
También existe una tercera vía intermedia: Checkout.js o link de pago, pensada para negocios que necesitan cobrar sin tocar código o sin integrar una plataforma completa.
La decisión entre plugin o API pasarela pagos no es solo técnica. Implica preguntarte qué plataforma usas, qué experiencia de checkout quieres ofrecer, cuánto control necesitas y qué tan autónomo es tu equipo para mantener la integración.
TAYPI funciona como pasarela de pagos QR interoperables, y cada cobro genera un QR dinámico único con monto fijo y referencia que expira en 15 minutos. La verificación del pago se hace directamente con la entidad financiera, sin capturas de pantalla. Desde esa base, estas son las opciones concretas de integración.
Si tu tienda usa WooCommerce, puedes instalar el plugin oficial de TAYPI y empezar a cobrar con Yape, Plin y cualquier billetera interoperable. El flujo se integra al checkout de WordPress sin desarrollar una pasarela desde cero.
Si tu negocio usa WHMCS para facturar servicios, hosting, membresías o renovaciones, el módulo oficial de TAYPI te permite sumar pagos QR a ese flujo. Es una ruta recomendada cuando tu operación ya depende de esa plataforma y no quieres duplicar desarrollos.
Para una tienda WooCommerce, también puedes revisar la guía de pagos QR en WooCommerce paso a paso.
No todas las plataformas tienen un plugin oficial de TAYPI. Si usas un CMS poco común, una tienda a medida, Shopify, PrestaShop u otro entorno sin módulo específico, no estás bloqueado: puedes usar Checkout.js o un link de pago.
Con estas opciones reduces la fricción:
Si quieres profundizar en esta vía, te conviene leer el artículo sobre Checkout.js, la forma rápida de aceptar pagos QR.
Cuando necesitas un control total del flujo, la opción es la API REST de TAYPI. Puedes integrarla con los SDKs oficiales de PHP, JavaScript/TypeScript y .NET, lo que cubre la mayoría de stacks modernos.
La API permite:
La documentación para developers de TAYPI reúne los recursos técnicos, entornos de sandbox y referencias de integración.
Un plugin oficial es la opción correcta cuando tu operación ya corre sobre una plataforma soportada y tu prioridad es salir a cobrar rápido.
En general, integrar TAYPI mediante un plugin oficial puede tomar alrededor de un día. No pagas costo de instalación ni mensualidad por la pasarela, y la activación es inmediata.
Un plugin no siempre alcanza. Si necesitas un checkout totalmente personalizado, lógica de negocio propia o integración con sistemas internos, puede quedarte corto. Además, solo existe plugin oficial para WooCommerce y WHMCS; en otras plataformas tendrás que evaluar Checkout.js, link de pago o API REST.
La API es la vía indicada cuando el checkout es parte de un producto digital, un ERP, un marketplace o un sistema con reglas propias. TAMBIÉN es la base para habilitar flujos avanzados de pago recurrente.
Con la API REST no dependes de la interfaz ni de las limitaciones de un CMS. Puedes decidir en qué momento creas el cobro, cómo muestras el QR, qué haces al recibir el webhook y cómo concilias cada transacción.
Esto es especialmente útil para:
Si tu negocio vende suscripciones, membresías o cobros recurrentes, la API encaja con una de las capacidades más potentes de TAYPI: Yape On File.
Con Yape On File, el cliente afilia su Yape una sola vez desde su propia app Yape. La solicitud de afiliación expira en 15 minutos. A partir de allí, el cliente puede:
El comercio también puede lanzar cobros on-demand a un cliente ya afiliado. Para los cobros recurrentes, TAYPI incluye un cobro inteligente: intenta cobrar el monto total y, si la transacción falla por saldo insuficiente, puede reintentar por partes, por ejemplo 50% + 50%. El comercio configura si desea cobrar siempre el 100% o recuperar al menos el 50% por partes, y define cuántos reintentos permite.
TAYPI no consulta ni verifica el saldo del cliente: simplemente intenta el cobro y, si falla, reintenta según la configuración. El cliente no participa en los reintentos, porque ya autorizó ese flujo al afiliarse. Además, puede desafiliarse cuando quiera desde su app Yape.
El pago en un clic con Yape On File está disponible para los comercios TAYPI y puedes solicitar su activación para tu cuenta.
Al usar API, la seguridad no es opcional. TAYPI incluye:
También puedes apoyarte en la guía de webhooks de pagos en tiempo real y en el artículo sobre [
Crea tu cuenta gratis y genera tu primer QR en minutos.
Abrir cuenta gratis