Pagos QR en Magento para tiendas en Perú
Cómo habilitar pagos QR interoperables en Magento para tu tienda en Perú, con verificación bancaria y depósito T+1.
Cómo habilitar pagos QR interoperables en Magento para tu tienda en Perú, con verificación bancaria y depósito T+1.
Si tienes una tienda en Magento y vendes en Perú, habilitar pagos QR Magento Perú te permite aceptar Yape, Plin y otras billeteras interoperables sin depender de tarjetas. Con la verificación bancaria directa y la liquidación T+1, reduces la fricción de pago y eliminas la validación manual de capturas. En esta guía te muestro cómo integrar una pasarela de QR interoperable en tu e-commerce Magento, sin extensiones oficiales, usando API REST o Checkout.js.
Los pagos QR Magento Perú son una forma de cobrar en tu tienda online usando el estándar de interoperabilidad del BCRP a través de la CCE. En lugar de pedir al cliente una tarjeta de crédito o débito, generas un QR dinámico que el cliente escanea desde Yape, Plin o cualquier billetera interoperable.
Este sistema tiene una diferencia clave frente a los QR estáticos que ves en tiendas físicas: cada cobro genera un QR dinámico único, con monto fijo y referencia, que expira en 15 minutos. No es un QR reutilizable que cualquiera pueda copiar o manipular. Eso aporta seguridad y trazabilidad a cada transacción.
Para una tienda Magento, habilitar este medio de pago es especialmente interesante porque el público peruano ya usa billeteras móviles a diario. No necesitas procesar tarjetas ni asumir contracargos. Además, el dinero se deposita directamente a tu cuenta bancaria vía CCI, sin saldos retenidos en una app. Si quieres entender mejor el ecosistema, revisa qué son los pagos QR interoperables en Perú y las diferencias entre QR estático y QR dinámico EMVCo.
Incorporar pagos QR en tu checkout Magento no es solo una tendencia: resuelve problemas concretos del e-commerce peruano. Estos son los principales beneficios:
Este medio de pago es especialmente atractivo para e-commerce que venden productos digitales, servicios, suscripciones o pedidos de montos moderados. Al eliminar las “capturas falsas” y la validación manual, tu equipo puede concentrarse en crecer, no en perseguir comprobantes. Si quieres conocer más sobre el pago con QR como método de cobro, consulta la página oficial.
Una pregunta frecuente es si existe un módulo oficial de TAYPI para Magento. La respuesta es no. TAYPI tiene plugins oficiales solo para WooCommerce y WHMCS. Sin embargo, eso no impide integrar pagos QR en tu tienda Magento: puedes hacerlo vía API REST, Checkout.js o link de pago.
La integración típica toma alrededor de un día y se apoya en el SDK de PHP (también hay SDKs para JavaScript/TypeScript y .NET). El flujo es simple: al confirmar la orden, tu backend hace una petición POST /api/v1/payments y recibe el QR dinámico y una URL de checkout. Luego muestras el QR al cliente en la página de pago o lo rediriges al checkout.
Estos son los métodos disponibles para Magento:
| Método | Disponible para Magento | Esfuerzo técnico | Ideal para |
|---|---|---|---|
| Extensión oficial TAYPI | No (solo WooCommerce y WHMCS) | — | No aplica |
| API REST + SDK PHP | Sí | Bajo-medio | Checkout personalizado |
| Checkout.js | Sí | Bajo | Checkout rápido sin backend complejo |
| Link de pago | Sí | Mínimo | Cotizaciones u órdenes manuales |
Para la implementación técnica, la autenticación se realiza con firma HMAC-SHA256, la idempotencia evita cobros duplicados y el sandbox te permite probar sin mover dinero real. Además, los webhooks en tiempo real notifican a Magento cuando el pago es confirmado. Puedes consultar la documentación para developers y la guía práctica cómo integrar pagos QR en tu tienda online en 5 minutos.
Uno de los puntos que más importa a un comercio Magento es cuándo y cómo recibe el dinero. Con la pasarela de pagos QR, el flujo es transparente:
Para recibir la liquidación T+1 necesitas ser un comercio Nivel 2, es decir, pasar la verificación KYB. Una vez verificado, no hay saldos retenidos: todo lo que cobras se transfiere a tu cuenta bancaria. El monto mínimo por transacción es S/ 1.00, lo que da flexibilidad para productos de bajo valor.
El panel del comercio te permite ver los cobros en tiempo real, gestionar clientes, productos y suscripciones, exportar reportes y conciliar cada pago con su referencia. La conciliación automática es clave para un e-commerce Magento con volumen, porque elimina la necesidad de cruzar manualmente pedidos y pagos.
El costo por aceptar pagos QR Magento Perú se calcula con una fórmula clara: (monto × 2.50% + número_de_cobros × S/ 0.20) × 1.18, donde el IGV del 18% se aplica sobre la comisión. No hay mensualidad, costo de instalación ni permanencia.
Esta tabla muestra cuánto pagas y cuánto recibes neto:
| Monto cobrado | Comisión variable (2.50%) | Comisión fija | IGV (18%) | Total comisión | Monto que recibes |
|---|---|---|---|---|---|
| S/ 50 | S/ 1.25 | S/ 0.20 | S/ 0.26 | S/ 1.71 | S/ 48.29 |
| S/ 100 | S/ 2.50 | S/ 0.20 | S/ 0.49 | S/ 3.19 | S/ 96.81 |
| S/ 200 | S/ 5.00 | S/ 0.20 | S/ 0.94 | S/ 6.14 | S/ 193.86 |
El ejemplo oficial en un cobro de S/ 100 es: comisión variable S/ 2.50 + fija S/ 0.20 + IGV S/ 0.49 = S/ 3.19; el comercio recibe S/ 96.81. Si quieres ver más detalles, consulta los precios de TAYPI.
El módulo destacado es Yape On File, una capacidad ya operativa para los comercios TAYPI. Permite que un cliente afilie su Yape una sola vez y, a partir de ahí, pague sin volver a escanear ni reingresar datos.
Así funciona:
El “cobro inteligente” para recurrentes tiene una lógica interesante: la pasarela intenta el monto total. Si la transacción falla por saldo insuficiente, reintenta por partes (por ejemplo, 50% + 50%) hasta completar. La pasarela no consulta ni verifica el saldo del cliente: solo intenta y, si falla, reintenta. El comercio configura el comportamiento: cobrar siempre solo el 100% o recuperar al menos el 50% por partes, y define cuántos reintentos permitir. El cliente no participa en estos reintentos porque ya autorizó al afiliarse.
Este mecanismo es muy útil para e-commerce Magento que venden membresías, cajas de suscripción, servicios recurrentes o cuotas. El cliente puede desafiliarse cuando quiera, y toda la autorización se realiza dentro de su app Yape. Si quieres conocer más, revisa pago con Yape.
Al integrar pagos QR en tu tienda Magento, es fundamental elegir una pasarela que cumpla con la regulación peruana y proteja tanto al comercio como al comprador. Estas son las capas de seguridad y cumplimiento que debes exigir:
Además, al no procesar tarjetas de crédito o débito, reduces la exposición a fraudes y contracargos. La pasarela TAYPI es operada por NEO TECHNOLOGY PERÚ E.I.R.L. (NEOTec), RUC 20605446788, en Lima, Perú, y es miembro de la Cámara de Comercio de Lima (CCL).
No. TAYPI solo tiene extensiones oficiales para WooCommerce y WHMCS. Para Magento, la integración se realiza mediante API REST, Checkout.js o link de pago, usando los SDKs oficiales (PHP, JavaScript/TypeScript, .NET).
Puedes aceptar Yape, Plin y cualquier billetera interoperable conectada a la interoperabilidad del BCRP a través de la CCE. No se procesan tarjetas de crédito ni débito.
La comisión es de 2.50% + S/ 0.20 + IGV (18% sobre la comisión) por cobro confirmado. No hay mensualidad, costo de instalación ni permanencia. Por un cobro de S/ 100, la comisión total es S/ 3.19 y recibes S/ 96.81.
El dinero se deposita a tu cuenta bancaria CCI al día hábil siguiente (T+1). Necesitas ser comercio Nivel 2 (KYB verificado). No hay saldos atrapados en una app.
La pasarela verifica la transacción directamente con la entidad financiera, no con capturas de pantalla. Si la pasarela confirma el pago, está pagado. Los webhooks en tiempo real notifican a tu tienda Magento para automatizar la confirmación de la orden.
Habilitar pagos QR Magento Perú es una decisión práctica para reducir la fricción de pago, eliminar la validación manual de capturas y cobrar con Yape, Plin y cualquier billetera interoperable. Aunque no existe una extensión oficial de TAYPI para Magento, la integración vía API REST o Checkout.js es accesible para
Crea tu cuenta gratis y genera tu primer QR en minutos.
Abrir cuenta gratis