# 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](https://github.com/Paymos-labs/odoo/releases/latest), 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.

```bash
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](/es/docs/support/refunds.md).
