Cómo cobrar con pagos QR en Odoo

Cobrar con pagos QR en Odoo es una de las formas más eficientes de automatizar el ciclo de ventas de tu ERP, reducir los errores manuales y ofrecer a tus clientes una experiencia de pago que ya usan todos los días con Yape, Plin y cualquier billetera interoperable. Si gestionas facturas, órdenes de venta o suscripciones en Odoo, integrar una pasarela de pagos QR Odoo te permite recibir dinero con verificación bancaria directa y conciliar cada cobro sin capturas de pantalla ni validaciones manuales.

En esta guía te explico cómo funciona la integración, cuánto cuesta, qué necesitas desde el lado técnico y por qué TAYPI es una alternativa práctica para sumar pagos QR a tu instancia de Odoo sin depender de un módulo oficial.

¿Qué son los pagos QR y por qué integrarlos en Odoo?

Un pago QR es una transacción que se inicia cuando el comprador escanea un código desde su app bancaria o billetera y confirma el monto. En Perú, la interoperabilidad del BCRP a través de la CCE permite que el QR sea pagable desde Yape, Plin y cualquier billetera interoperable, sin importar la entidad financiera de origen.

Para un ERP como Odoo, esto tiene una ventaja enorme: el cobro deja de ser un proceso externo al sistema. Con una integración de pagos QR Odoo, cada factura, pedido o cuota puede generar un QR dinámico con monto fijo y referencia única, y quedar registrada automáticamente cuando el pago se confirma.

Además, al operar sobre la infraestructura de pagos interoperables del BCRP (vía la Cámara de Compensación Electrónica), los pagos QR son verificados directamente con la entidad financiera. Esto elimina las capturas falsas y el trabajo de revisar manualmente si una transferencia realmente se concretó.

Conviene aclarar que Odoo no incluye de fábrica un conector nativo para pagos QR interoperables peruanos. Por eso, la vía más limpia es integrar una pasarela mediante API REST y webhooks, como explicaré más adelante. Si quieres entender mejor cómo funciona la interoperabilidad QR en Perú, te recomiendo leer esta guía sobre la CCE.

¿Cómo funciona la integración de pagos QR en Odoo con TAYPI?

TAYPI es una pasarela de pagos peruana que permite cobrar con QR interoperable y verificación directa con la entidad financiera. A diferencia de otras herramientas, no tiene un módulo oficial para Odoo (sus módulos oficiales son para WooCommerce y WHMCS), pero eso no es una limitación real: su API REST y webhooks permiten una integración limpia desde cualquier backend.

El flujo típico de pagos QR Odoo con TAYPI funciona así:

1. Desde Odoo, tu sistema genera una solicitud de pago con el monto y una referencia interna (por ejemplo, el número de factura o de pedido).
2. TAYPI responde con un QR dinámico único y un checkout_url. Ese QR expira en 15 minutos y no es reutilizable.
3. El cliente escanea el QR desde Yape, Plin o cualquier billetera interoperable y confirma el pago.
4. TAYPI verifica la transacción directamente con la entidad financiera y notifica el resultado a tu backend de Odoo mediante un webhook en tiempo real.
5. Odoo valida la firma HMAC-SHA256, aplica idempotencia para evitar duplicados y marca la factura como pagada.

Para el desarrollo, TAYPI ofrece SDKs en PHP, JavaScript/TypeScript y .NET, lo que facilita la implementación en el backend de Odoo. Una integración típica toma alrededor de un día de trabajo. Si quieres revisar la documentación técnica, puedes visitar la documentación para developers de TAYPI.

La pieza clave del flujo es el webhook. Te recomiendo leer esta guía completa sobre webhooks de pagos en tiempo real para entender cómo configurar la recepción de notificaciones de cobro en tu instancia de Odoo.

Paso a paso: implementa pagos QR en Odoo

Aunque cada instancia de Odoo tiene particularidades, el proceso de integración de pagos QR Odoo sigue una ruta clara. Aquí tienes los pasos esenciales:

1. Crea tu cuenta en TAYPI. El registro es inmediato y no tiene costo de instalación ni mensualidad. Puedes crear tu cuenta gratis en TAYPI para empezar a probar.
2. Obtén tus credenciales de API. Dentro del panel de TAYPI encontrarás claves de sandbox para pruebas y claves de producción para el entorno real. La autenticación usa firma HMAC-SHA256.
3. Genera el cobro desde Odoo. Usa el endpoint POST /api/v1/payments para enviar el monto y la referencia de la factura. TAYPI devuelve el QR y un enlace de pago.
4. Muestra el QR al cliente. Puedes incluirlo en la vista de factura de Odoo, enviarlo por correo o mostrarlo en un portal de cliente. El QR es de un solo uso y expira en 15 minutos.
5. Configura los webhooks. Registra una URL de tu instancia Odoo para recibir notificaciones de pago. Cada evento incluye la referencia que enviaste, lo que facilita la conciliación.
6. Verifica la firma HMAC-SHA256. Antes de dar por pagada una factura, tu backend debe validar que el webhook realmente proviene de TAYPI. Aquí te explico cómo verificar firmas HMAC-SHA256 en tu backend.
7. Aplica idempotencia. Si un webhook se reenvía o tu sistema lo procesa dos veces, la idempotencia evita que registres un cobro duplicado.
8. Marca la factura como pagada y concilia. Con la referencia y el estado del pago confirmados, Odoo puede actualizar automáticamente el estado de la factura y generar el asiento contable correspondiente.

Este flujo elimina la necesidad de descargar reportes, cruzar capturas o verificar manualmente cada transferencia. Todo queda atado a la referencia que enviaste desde Odoo.

Ventajas de la conciliación automática en Odoo

Una de las mayores fricciones al cobrar con QR de forma manual es la conciliación: revisar qué cliente pagó, cuánto pagó y a qué factura corresponde. Con una integración de pagos QR Odoo, esa conciliación se automatiza.

TAYPI asocia cada cobro a la referencia que enviaste desde Odoo. Si usas el número de factura como referencia, el webhook te devuelve ese mismo identificador, por lo que puedes actualizar el estado de la factura sin ambigüedad.

Además, como la verificación se hace directamente con la entidad financiera, no dependes de que el cliente envíe una captura de pantalla. Si TAYPI confirma el pago, está pagado.

Aspecto	Gestión manual de pagos QR	Integración de pagos QR Odoo con TAYPI
Generación del QR	Crear un QR estático o por cada cobro a mano	Dinámico y automático desde Odoo
Verificación del pago	Capturas de pantalla o revisión manual	Verificación bancaria directa vía API
Conciliación	Manual, propensa a errores	Automática por referencia única
Riesgo de duplicados	Alto si no hay control	Controlado con idempotencia
Tiempo de gestión	Minutos por transacción	Casi cero después de implementar

Esta automatización es especialmente útil para empresas que manejan decenas o cientos de cobros al día: reduce el tiempo de cierre contable y te deja enfocarte en el negocio.

Costos y comisiones de los pagos QR Odoo

Uno de los factores más importantes al elegir una pasarela de pagos QR Odoo es el costo. En el caso de TAYPI, la comisión es 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

Veamos un ejemplo concreto con un cobro de S/ 100:

• Comisión variable: S/ 2.50
• Comisión fija: S/ 0.20
• IGV: S/ 0.49
• Total comisión: S/ 3.19
• El comercio recibe: S/ 96.81

Además, TAYPI no cobra mensualidad, ni costo de setup ni permanencia. El monto mínimo por transacción es de S/ 1.00, y la activación es inmediata una vez completas la verificación del comercio.

Otro punto a favor: al no procesar tarjetas de crédito o débito, no hay contracargos ni comisiones de marca de tarjetas. Esto reduce el riesgo y simplifica la estructura de costos. Puedes consultar los precios de TAYPI para más detalle.

La liquidación es T+1, es decir, el dinero se deposita a tu cuenta bancaria (vía CCI) al día hábil siguiente. No hay saldos retenidos en una app, lo que facilita la gestión de flujo de caja desde Odoo.

Yape On File: cobros recurrentes y pago en un clic en Odoo

Para negocios que gestionan suscripciones o cobros recurrentes en Odoo, TAYPI ofrece un módulo destacado: Yape On File. Esta funcionalidad permite que un cliente afilie su Yape una sola vez y, a partir de ahí, pague en un clic sin volver a escanear ni reingresar datos.

Además del pago en un clic, Yape On File habilita cobros recurrentes automáticos que TAYPI ejecuta en nombre del comercio según los mandatos autorizados por el cliente. Esto es particularmente útil para cuotas, membresías o suscripciones facturadas desde Odoo.

El módulo incluye:

• Cobros on-demand: lanzas un cobro puntual a un cliente afiliado.
• Cobro inteligente para recurrentes: TAYPI ejecuta el cobro e intenta el monto total. Si la transacción falla por saldo insuficiente, reintenta por partes (por ejemplo, 50% + 50%) hasta completar. El cliente no participa en los reintentos, porque ya autorizó al afiliarse.
• Configuración flexible: el comercio define si cobrar siempre solo el 100% (si falla, no cobra ese ciclo) o recuperar al menos el 50% por partes, y establece cuántos reintentos permitir.

La afiliación del cliente se realiza una sola vez y la solicitud expira en 15 minutos. Todo se autoriza desde la propia app de Yape con verificación cifrada, y el cliente puede desafiliarse cuando quiera. Este pago en un clic con Yape ya está disponible para los comercios de TAYPI; puedes solicitar su activación desde el panel.

Seguridad y cumplimiento regulatorio en pagos QR Odoo

Al integrar pagos QR Odoo, es fundamental que la pasarela cumpla con la normativa peruana y ofrezca garantías técnicas. TAYPI 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.

Entre los aspectos de seguridad más relevantes para tu integración en Odoo están:

• Verificación bancaria directa: no se aceptan capturas de pantalla; la pasarela confirma el pago con la entidad financiera.
• QR de un solo uso: cada cobro genera un QR dinámico único que expira en 15 minutos.
• Idempotencia: evita cobros duplicados ante reintentos o problemas de red.
• Firmas HMAC-SHA256: autentican y validan la integridad de cada solicitud y webhook.
• Cifrado TLS 1.3: protege la comunicación entre Odoo y la pasarela.

En cumplimiento normativo, TAYPI sigue las obligaciones de PLAFT (prevención de lavado de activos) conforme a la regulación de la SBS y la UIF-Perú. Además, cuenta con certificaciones ISO 27001:2022 (seguridad de la información) e ISO 9001:2015 (gestión de calidad), y es miembro de la Cámara de Comercio de Lima.

Si quieres profundizar en los protocolos técnicos, revisa la guía sobre cómo verificar firmas HMAC-SHA256 en tu backend y la página de seguridad de TAYPI.

Preguntas frecuentes

¿TAYPI tiene un módulo oficial para Odoo?

No. TAYPI no ofrece un módulo oficial para Odoo. Sus integraciones oficiales son para WooCommerce y WHMCS. Sin embargo, la integración con Odoo es totalmente posible a través de su API REST y webhooks, usando los SDKs de PHP, JavaScript/TypeScript o .NET en el backend.

¿Cuánto demora implementar pagos QR en Odoo?

Con la API REST de TAYPI, una integración típica toma alrededor de un día de trabajo. Esto incluye generar el QR, configurar los webhooks y validar la firma HMAC-SHA256 en tu backend de Odoo.

¿Los pagos QR en Odoo aceptan Yape y Plin?

Sí. Los pagos QR generados con TAYPI son interoperables y pueden pagarse desde Yape, Plin y cualquier billetera o banco conectado a la interoperabilidad del BCRP a través de la CCE. No se procesan tarjetas de crédito o débito.

¿Cómo se evitan cobros duplicados en Odoo?

La idempotencia es la clave. Cada solicitud de pago incluye un identificador único, y los webhooks se procesan de forma idempotente. Si un webhook llega dos veces, el segundo no genera un cobro duplicado. Además, la verificación con la entidad financiera garantiza que solo se registre un pago confirmado.

¿Puedo usar la integración para cobros recurrentes en Odoo?

Sí. Con el módulo Yape On File de TAYPI, puedes afiliar a tus clientes una sola vez y ejecutar cobros recurrentes automáticos o cobros on-demand desde Odoo. Es ideal para suscripciones, membresías y cuotas.

Conclusión

Los pagos QR Odoo te permiten convertir tu ERP en el centro de tu operación de cobros, sin depender de procesos manuales ni validaciones externas. Al integrar TAYPI mediante API REST y webhooks, obtienes un flujo de pago con QR interoperable, verificación bancaria directa y conciliación automática por referencia. Además, eliminas los contracargos y las comisiones de tarjetas, con una estructura de comisión clara y liquidación T+1.

Si ya usas Odoo para facturar o gestionar pedidos, dar el paso hacia una integración de pagos QR es una mejora operativa significativa. Evalúa tus necesidades técnicas, revisa la documentación para developers y comienza con una prueba en sandbox. La inversión de tiempo es baja y el retorno en automatización es alto.

---

Para empezar a cobrar con pagos QR en Odoo, crea tu cuenta gratuita en TAYPI y activa tus claves de prueba hoy mismo.