Cómo integrar pagos QR en PrestaShop

Integrar pagos QR PrestaShop es una de las decisiones más prácticas para aceptar Yape, Plin y cualquier billetera interoperable directamente en tu tienda online. Si administras un e-commerce en Perú, sabes que depender de transferencias manuales o validar capturas de pantalla complica la conciliación y resta confianza. En este tutorial te explico cómo conectar PrestaShop con TAYPI, una pasarela de pagos QR interoperable, usando opciones reales: API REST, Checkout.js o link de pago.

Por qué sumar pagos QR PrestaShop a tu tienda

Si tienes una tienda en PrestaShop, el checkout es uno de los puntos donde más ventas puedes ganar o perder. Los pagos QR interoperables eliminan la fricción de digitar números de cuenta, montos y referencias. El cliente escanea, confirma en su billetera y listo.

En el contexto peruano, aceptar pagos QR PrestaShop te permite recibir dinero desde Yape, Plin y cualquier billetera conectada a la interoperabilidad del BCRP a través de la CCE. No necesitas pedirle al cliente que envíe una captura, ni revisar manualmente si el pago llegó. La verificación se hace directamente con la entidad financiera: si el proveedor confirma el pago, está pagado.

Además, al trabajar solo con billeteras y QR interoperable, no procesas tarjetas. Esto significa cero contracargos y sin comisiones de marca de tarjetas. Para un e-commerce de ticket bajo o medio, esa previsibilidad en los costos es una ventaja concreta.

Otra razón importante es la conciliación automática. Cada cobro se asocia a su referencia, por lo que puedes cruzar pedidos de PrestaShop con pagos confirmados sin planillas manuales. Y como la liquidación es T+1, el dinero se deposita a tu CCI al día hábil siguiente, sin saldos atrapados en una app.

Qué necesitas antes de integrar pagos QR en PrestaShop

Antes de escribir código o instalar cualquier cosa, conviene dejar listos algunos requisitos. Estos son los elementos básicos para una integración estable:

• Cuenta de comercio verificada: para recibir pagos reales y liquidar a tu CCI, necesitas una cuenta de comercio Nivel 2 con verificación KYB. La activación es inmediata y no tiene costo de instalación, mensualidad ni permanencia.
• Credenciales de API: debes obtener tus claves de sandbox para pruebas y luego las claves de producción.
• Entorno PrestaShop con HTTPS: tu tienda debe exponer un webhook accesible públicamente. El cifrado TLS es obligatorio para proteger los datos del checkout.
• Conocimientos básicos de backend: como no hay un módulo oficial para PrestaShop, la integración se hace mediante API REST o Checkout.js. Si no desarrollas, puedes contratar a un integrador o usar un link de pago como alternativa rápida.
• Documentación técnica a la mano: revisa la guía de documentación para developers y familiarízate con los endpoints de creación de pagos, webhooks y firmas HMAC-SHA256.

También conviene definir cómo manejarás los estados del pedido en PrestaShop. Por ejemplo, “pago pendiente”, “pagado” y “expirado”. La pasarela devuelve un QR dinámico con expiración de 15 minutos, así que tu checkout debe contemplar la caducidad del intento de pago.

Opciones reales de integración de pagos QR PrestaShop

TAYPI no tiene un módulo oficial para PrestaShop. Los plugins oficiales disponibles son para WooCommerce y WHMCS. Sin embargo, eso no impide integrar pagos QR PrestaShop de forma profesional. Tienes tres rutas reales, y cada una se adapta a distintos niveles de control y desarrollo.

Opción de integración	Complejidad	Personalización	Ideal para
API REST	Media-alta	Alta: controlas todo el flujo y los estados del pedido	Tiendas con desarrollo propio o agencia
Checkout.js	Baja-media	Media: insertas el checkout sin crear todo desde cero	Implementaciones rápidas en el frontend
Link de pago	Baja	Baja: generas URL de cobro manualmente	Pedidos por WhatsApp o ventas asistidas

La integración por API REST te permite generar un pago con POST /api/v1/payments, obtener el QR y el checkout_url, y guardar la referencia en el pedido de PrestaShop. Luego, mediante webhooks en tiempo real, actualizas el estado del pedido cuando la pasarela confirma el pago. Esta opción es la más recomendada si quieres automatizar todo el ciclo de compra.

Si buscas una implementación más ligera, puedes usar Checkout.js. Esta alternativa te permite aceptar pagos QR con Checkout.js sin construir toda la interfaz desde cero. Es una buena salida cuando necesitas lanzar rápido y no quieres pelear con UI.

Por último, el link de pago no requiere integración técnica. Puedes generarlo desde el panel de la pasarela y enviarlo al cliente por correo o WhatsApp. Es una solución transitoria, pero no reemplaza la automatización que un e-commerce formal necesita.

Paso a paso: integración de pagos QR PrestaShop

A continuación te detallo un flujo general basado en API REST. Asume que ya tienes tu cuenta de comercio y tu tienda PrestaShop con HTTPS.

1. Crea tu cuenta y obtén credenciales

Regístrate en la plataforma de la pasarela y completa la verificación de tu negocio. Luego, en el panel, genera tus claves de sandbox. Estas claves te permiten probar todo sin mover dinero real. No pases a producción hasta que hayas validado el flujo completo.

2. Prepara tu entorno de pruebas

En tu PrestaShop de staging, crea una página o controlador de checkout que invoque la API de pagos. Asegúrate de guardar en tu backend el payment_id que devuelve la pasarela, porque lo necesitarás para conciliar y validar webhooks.

3. Crea el pago con API REST

Cuando el cliente elige pagar con QR, tu backend debe llamar a POST /api/v1/payments con el monto, la moneda y una referencia única del pedido. La respuesta incluye el QR dinámico y el checkout_url. Muestra ese QR en pantalla y deja un temporizador visible de 15 minutos.

4. Implementa firma HMAC-SHA256 e idempotencia

Cada solicitud debe ir firmada con HMAC-SHA256. Esto garantiza que nadie alteró el monto ni la referencia. También debes enviar un identificador de idempotencia para evitar cobros duplicados si el cliente reintenta el mismo pedido. Puedes revisar la guía de cómo verificar firmas HMAC-SHA256 en tu backend.

5. Configura webhooks para confirmar pagos

La pasarela notifica a tu PrestaShop cuando el pago es confirmado. Tu webhook debe validar la firma del mensaje, buscar el payment_id o la referencia asociada y actualizar el estado del pedido a “pagado”. Consulta la guía completa de webhooks de pagos en tiempo real para implementar reintentos y respuestas correctas.

6. Prueba en sandbox y puesta en producción

Haz pruebas con montos mínimos, simula pagos exitosos y pagos fallidos, y verifica que la conciliación automática funcione. Cuando estés seguro, cambia a claves de producción y monitorea los primeros cobros reales. Si no quieres desarrollar desde cero, recuerda que también puedes usar Checkout.js o contratar a un integrador.

Costos y comisiones de pagos QR PrestaShop

Uno de los puntos que más interesa a un e-commerce es cuánto paga por cada cobro. La pasarela que mencionamos no cobra instalación, mensualidad ni permanencia. Solo pagas una comisión por cobro confirmado.

La fórmula oficial es:

(monto × 2.50% + número_de_cobros × S/ 0.20) × 1.18

El IGV se aplica sobre la comisión. Para un cobro de S/ 100, el cálculo queda así:

Concepto	Monto
Comisión variable (2.50%)	S/ 2.50
Comisión fija	S/ 0.20
IGV sobre comisión	S/ 0.49
Total deducido	S/ 3.19
Tu comercio recibe	S/ 96.81

El monto mínimo por transacción es de S/ 1.00. La liquidación es T+1 a tu CCI, siempre que seas comercio Nivel 2 con KYB verificado. Estos costos predecibles son una ventaja frente a modelos que mezclan comisiones por tarjetas, contracargos o saldos retenidos.

Puedes revisar más detalles en la página de precios de la pasarela.

Seguridad y cumplimiento en pagos QR PrestaShop

Cuando integras pagos QR PrestaShop a través de una pasarela regulada, no solo estás facilitando el cobro: también estás protegiendo tu negocio y a tus clientes.

La verificación bancaria directa elimina la dependencia de capturas de pantalla. El QR es dinámico, de un solo uso y expira en 15 minutos, lo que reduce el riesgo de reutilización. La integración se apoya en cifrado TLS 1.3, firmas HMAC-SHA256 e idempotencia para evitar cobros duplicados.

En materia regulatoria, la pasarela cumple con la normativa PLAFT conforme a la normativa peruana de SBS y 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 una EEDE regulada. Además, cuenta con certificaciones ISO 27001:2022 en seguridad de la información e ISO 9001:2015 en gestión de calidad.

Para tu tienda PrestaShop, esto significa que la confirmación de pago es confiable y que puedes automatizar la liberación de pedidos sin revisión manual. Si quieres profundizar, consulta la seguridad de TAYPI o la guía sobre qué es PLAFT y por qué tu pasarela debe cumplirla.

Yape On File y suscripciones: el extra que puedes activar

Si además de pagos puntuales quieres ofrecer cobros recurrentes o suscripciones, la pasarela incluye una funcionalidad destacada: Yape On File. Este módulo ya está disponible para los comercios y puede solicitarse su activación.

El funcionamiento es simple. El cliente afilia su Yape una sola vez desde su propia app, con una solicitud que expira en 15 minutos. A partir de ahí, puede pagar en un clic, sin escanear QR ni reingresar datos. Esa afiliación también permite suscripciones y cobros recurrentes que la pasarela ejecuta automáticamente en nombre del comercio, según los mandatos autorizados.

Para los cobros recurrentes, el comercio puede configurar un cobro inteligente: la pasarela intenta primero el monto total. Si la transacción falla por saldo insuficiente, reintenta por partes, como 50% + 50%, hasta completar. El cliente no participa en los reintentos, porque ya autorizó al afiliarse. La pasarela no consulta el saldo del cliente; solo intenta y, si falla, reintenta según tu configuración.

Tú defines si prefieres cobrar siempre el 100% o recuperar al menos el 50% por partes, y cuántos reintentos permitir. El cliente puede desafiliarse cuando quiera desde su app Yape. Para un PrestaShop que vende membresías, cajas de suscripción o acceso a contenido, esta capacidad abre un escenario interesante sin contracargos de tarjetas.

Preguntas frecuentes

¿PrestaShop tiene un módulo oficial de TAYPI?

No. TAYPI no ofrece un módulo oficial para PrestaShop. Los módulos oficiales disponibles son para WooCommerce y WHMCS. Sin embargo, puedes integrar PrestaShop mediante API REST, Checkout.js o link de pago.

¿Puedo cobrar con Yape y Plin en PrestaShop?

Sí. Al integrar pagos QR PrestaShop con una pasarela interoperable, aceptas Yape, Plin y cualquier billetera conectada a la interoperabilidad del BCRP a través de la CCE. No procesa tarjetas, lo que elimina contracargos.

¿Cuánto cuesta integrar pagos QR en PrestaShop?

La integración en sí no tiene costo de instalación, mensualidad ni permanencia. Solo pagas una comisión por cobro confirmado: 2.50% + S/ 0.20 + IGV. Por ejemplo, en S/ 100 se descuenta S/ 3.19 y recibes S/ 96.81.

¿La integración permite confirmar pagos automáticamente?

Sí. Mediante webhooks en tiempo real y firma HMAC-SHA256, tu PrestaShop puede actualizar el pedido a “pagado” en cuanto la pasarela confirma la transacción. No necesitas validar capturas ni revisar manualmente.

¿Qué pasa si un cliente no paga el QR en 15 minutos?

El QR dinámico expira. Si el cliente no completa el pago, la pasarela no lo confirma y tu pedido queda como pendiente o expirado. Luego puedes generar un nuevo intento de cobro con una referencia distinta.

Conclusión

Integrar pagos QR PrestaShop te permite automatizar cobros, eliminar la validación manual y aceptar Yape, Plin y billeteras interoperables con confirmación bancaria directa. No necesitas depender de capturas ni perseguir transferencias: el webhook actualiza el pedido y la liquidación T+1 llega a tu CCI.

Aunque no exista un módulo oficial para PrestaShop, la integración por API REST o Checkout.js es viable y robusta. Solo necesitas tus credenciales, un entorno HTTPS y una implementación cuidadosa de firmas e idempotencia. Si buscas una alternativa rápida, el link de pago puede sacarte de apuros mientras preparas la integración completa.

Evalúa tus necesidades de automatización, el volumen de ventas y la posibilidad de sumar Yape On File para suscripciones. Con una pasarela interoperable y bien integrada, tu PrestaShop puede ofrecer un checkout más simple, confiable y alineado con cómo pagan los peruanos hoy.

---

Si quieres empezar a cobrar con QR interoperable en PrestaShop, crea tu cuenta gratis en TAYPI y accede a la documentación técnica para integrar pagos en minutos.