En esta página
Configura Paymos en Odoo 20.0
Instala el módulo de Paymos en tu tienda Odoo, prueba un pedido en Sandbox y gestiona las devoluciones desde Odoo.
Con Paymos, tu cliente hace el pedido en Odoo y paga en la página de Paymos. El pedido y el resultado del pago quedan en Odoo.
Qué necesitas
El módulo es gratuito y se distribuye con licencia LGPL-3.0-only. Está pensado para una instalación propia de Odoo 20.0 con tienda HTTPS y los módulos payment, account_payment y website_sale. Las pruebas se hicieron con Python 3.12. Odoo Online no admite el módulo. Odoo.sh queda por probar.
Ten a mano una cuenta y un proyecto en Paymos. En Odoo necesitas acceso como administrador del sistema a la empresa de la tienda y un diario bancario de esa empresa con una línea Paymos para pagos entrantes.
Instala el módulo
Si hay un ZIP publicado en GitHub Releases, descárgalo. Comprueba por separado si el módulo aparece en Odoo Apps. Extrae payment_paymos/ y requirements.txt en una carpeta de addons_path. Desde esa carpeta, usa el Python con el que arranca Odoo y los paquetes wheel preparados para ese entorno.
python -m pip install --no-index --find-links /path/to/wheels --require-hashes -r requirements.txt
El archivo fija la versión de typing-extensions para Python anterior a 3.13. Guarda tu clave Fernet en la configuración protegida del servicio con el nombre PAYMOS_ODOO_ENVELOPE_KEY. Reinicia Odoo, actualiza la lista de aplicaciones e instala Paymos Payments.
Conecta el proyecto y prueba un pedido
En Payment Providers, abre Paymos y elige Connect Paymos. Autoriza el proyecto y selecciona el diario bancario. Habilita y publica el método en Sandbox. Haz un pedido en la tienda y comprueba el resultado en Odoo. Para empezar a cobrar, pulsa Select Live, revisa el diario y vuelve a habilitar y publicar el método.
Cuándo se confirma el pedido
Al crear la factura por API, Odoo envía solo el ID del proyecto, el importe total, la moneda y una referencia opaca del pedido. La solicitud no incluye datos de identidad del comprador.
El módulo comprueba la firma HMAC del aviso y coteja el pago por API. Un pago coincidente que cubre todo el importe confirma el pedido una sola vez. Los pagos insuficientes, tardíos o con datos distintos no lo confirman. Si el aviso no llega, una tarea programada consulta el estado con un límite de intentos.
Devuelve un pago o un excedente
Para devolver el pago completo, abre el registro del pago en Contabilidad de Odoo, pulsa Refund e introduce el importe original exacto. Si solo vas a devolver lo pagado de más, abre la transacción de pago y pulsa Refund Paymos overpayment. Paymos calcula cuánto corresponde devolver y lo envía al pagador registrado. Mientras se procesa la devolución, Odoo la mantiene pendiente. Para consultar los estados y plazos, abre la guía de devoluciones.