Перейти к содержимому
Плагины
Открыть .md
На странице

Как подключить 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. Откройте страницу последнего релиза. Если ZIP опубликован, скачайте его. Наличие модуля в Odoo Apps проверяйте отдельно. Распакуйте папку payment_paymos и файл requirements.txt в один из каталогов, указанных в addons_path.

  2. Установите зависимости тем же Python, на котором работает Odoo. Для Python ниже 3.13 заранее положите wheel typing-extensions 4.15.0 в каталог с пакетами. Подставьте путь к этому каталогу и запустите команду рядом с requirements.txt. Pip проверит хеш пакета и возьмёт его из указанного каталога.

    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.