# Set up Paymos payments in Odoo 20.0

> Install Paymos Payments on a self-hosted Odoo 20.0 site, test hosted checkout in Sandbox, and issue verified refunds from Odoo.

Paymos Payments adds crypto payments to your Odoo website checkout. The module is free and licensed under LGPL-3.0-only.

## Check your Odoo setup

Use a self-hosted Odoo 20.0 installation with `payment`, `account_payment`, and `website_sale`. We verified the module on Python 3.12. Odoo Online does not support it. Odoo.sh remains unverified.

Your storefront needs a public HTTPS URL. Have your Paymos account and project ready, and sign in as an Odoo system administrator authorized for the store’s company. That company needs a bank journal with a Paymos inbound payment method line.

## Install from the release ZIP

If a public ZIP is listed in [GitHub Releases](https://github.com/Paymos-labs/odoo/releases/latest), download it before you go offline. Check Odoo Apps separately for a directory listing. Extract `payment_paymos` and `requirements.txt` side by side in a directory on Odoo’s `addons_path`.

Use the same Python environment as Odoo. The requirements file pins and hash-checks `typing-extensions` for Python versions below 3.13. Put the matching wheel in your local wheel directory, then run pip from the directory containing `requirements.txt`.

```sh
python -m pip install --no-index --find-links /path/to/wheels --require-hashes -r requirements.txt
```

Set `PAYMOS_ODOO_ENVELOPE_KEY` to your own Fernet key in the Odoo service’s secret configuration. Keep the key out of terminal output. Restart Odoo, refresh the Apps list, and install **Paymos Payments**.

## Connect the provider and test a payment

In **Payment Providers**, open **Paymos** and click **Connect Paymos**. Approve the project in Paymos and select the company’s bank journal. Start in Sandbox. Enable and publish the provider there and run a test checkout. After the test, use **Select Live**, verify the settings, and enable and publish the provider again.

## What confirms an order

The buyer pays on the Paymos-hosted page. The invoice request carries only the project ID, order total and currency, and an opaque order reference in the payload. The payload includes no buyer identity. Paymos operates the hosted payment service and its [privacy policy](https://paymos.io/privacy) applies there.

The module checks the HMAC signature and verifies the invoice against the Paymos API. Odoo confirms the order once, after that check establishes that the payment covers the order. Partial, late, or mismatched payments leave the order unconfirmed. A scheduled job checks unresolved invoices in bounded batches when a signed notification is missed.

## Refund from the payment transaction

Open the payment record in Odoo Accounting, click **Refund**, and enter the exact original amount. To return only the excess, open the payment transaction and click **Refund Paymos overpayment**. Paymos calculates the amount to send and returns it to the recorded payer. Odoo updates the payment record after Paymos confirms the refund. While Paymos is processing the refund, Odoo shows it as pending.

See [how refunds work](/docs/support/refunds.md).
