# Как подключить Paymos к интернет-магазину на Odoo

> Установите Paymos Payments в Odoo 20.0, подключите свой проект Paymos и проверьте оплату криптовалютой на тестовом заказе.

Paymos Payments добавляет оплату криптовалютой на страницу оформления заказа в Odoo. Модуль бесплатный, лицензия — LGPL-3.0-only.

## Что понадобится

Инструкция рассчитана на Odoo 20.0 на своём сервере с интернет-магазином `website_sale`. Модуль проверили на Python 3.12. Odoo Online не поддерживается. Совместимость с Odoo.sh пока не проверяли.

Откройте доступ к магазину по HTTPS. Подготовьте аккаунт и проект Paymos, а в Odoo войдите с правами системного администратора нужной компании. Убедитесь, что установлены `payment`, `account_payment` и `website_sale`. У этой же компании должен быть банковский журнал с Paymos в списке способов входящего платежа.

## Как установить модуль

1. Откройте [страницу последнего релиза](https://github.com/Paymos-labs/odoo/releases/latest). Если ZIP опубликован, скачайте его. Наличие модуля в Odoo Apps проверяйте отдельно. Распакуйте папку `payment_paymos` и файл `requirements.txt` в один из каталогов, указанных в `addons_path`.
2. Установите зависимости тем же Python, на котором работает Odoo. Для Python ниже 3.13 заранее положите [wheel typing-extensions 4.15.0](https://pypi.org/project/typing-extensions/4.15.0/#files) в каталог с пакетами. Подставьте путь к этому каталогу и запустите команду рядом с `requirements.txt`. Pip проверит хеш пакета и возьмёт его из указанного каталога.

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

3. Задайте собственный ключ Fernet в переменной `PAYMOS_ODOO_ENVELOPE_KEY` через защищённую конфигурацию сервиса Odoo. Перезапустите сервис.

4. Обновите список приложений в **Apps** и установите **Paymos Payments**.

## Как подключить Paymos и проверить заказ

Откройте **Payment Providers → Paymos** и нажмите **Connect Paymos**. В Paymos проверьте текущий проект и подтвердите подключение. Вернувшись в Odoo, укажите банковский журнал вашей компании.

В **Sandbox** включите и опубликуйте Paymos. Создайте заказ, выберите Paymos и завершите тестовую оплату. Убедитесь, что заказ подтвердился после полной оплаты. Затем нажмите **Select Live**, снова включите и опубликуйте Paymos.

## Когда Odoo подтверждает заказ

Для счёта Odoo передаёт проект, точную сумму и валюту заказа, а также служебный идентификатор заказа. В запросе к API для создания счёта нет личных данных покупателя.

Odoo подтверждает заказ один раз, когда проверит подпись уведомления, сверит платёж через API Paymos и убедится, что заказ полностью оплачен. При недоплате, запоздалом платеже или расхождении в данных заказ не подтвердится. Если уведомление не пришло, Odoo проверяет платёж по расписанию ограниченное число раз.

## Как вернуть платёж или переплату

Чтобы вернуть всю оплату, откройте запись о платеже в бухгалтерии Odoo, нажмите **Refund** и укажите точную сумму исходного платежа. Чтобы вернуть только переплату, откройте платёжную транзакцию и нажмите **Refund Paymos overpayment**. Paymos рассчитывает сумму возврата и отправляет её плательщику. Пока Odoo не подтвердит возврат по данным Paymos, он остаётся в ожидании.

См. [как работают возвраты в Paymos](/ru/docs/support/refunds.md).
