Skip to Content

Payment Provider: Plata by Monobank

by
Odoo

$ 74.46

v 19.0 Third Party
This module requires Odoo Enterprise Edition.
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Website (website)
• eCommerce (website_sale)
• Invoicing (account)
• Discuss (mail)
Lines of code 294
Technical Name nf_monopay_payment
LicenseOPL-1
Websitehttps://netframe.org/
Versions 17.0 18.0 19.0
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Website (website)
• eCommerce (website_sale)
• Invoicing (account)
• Discuss (mail)
Lines of code 294
Technical Name nf_monopay_payment
LicenseOPL-1
Websitehttps://netframe.org/
Versions 17.0 18.0 19.0
Features How it Works Configuration Support

Payment Provider: Plata by Monobank

Accept online payments on your Odoo website with plata by mono — Monobank Acquiring. Buyers pay on plata by mono side and the order is confirmed automatically via signed webhooks.

Card, Apple Pay & Google Pay Signed webhooks (ECDSA) UAH · USD · EUR Automatic invoicing
Key Features
Hosted Payment Page

An invoice is created through the Monobank API and the buyer is redirected to the secure pay.monobank.ua page — card data never touches your server.

Signed Webhook Verification

Every webhook from Monobank is verified with an ECDSA + SHA256 signature against the merchant public key — forged status updates are rejected.

Automatic Status Updates

Transaction status is synced automatically as Monobank reports it: pending → authorized → done / canceled — no manual reconciliation needed.

Multi-Currency

Supports UAH, USD and EUR. The provider is offered at checkout only when the order currency is supported.

Automatic Invoice

With Odoo's Automatic Invoice enabled, a paid invoice is created and reconciled on successful payment — the order moves straight to Paid.

Provider Restrictions

Limit availability by maximum amount, currencies and countries. Orders that don't match the rules simply won't see the provider at checkout.

Test Mode

Use a test token to try the full flow with any Luhn-valid card — no real charge. Switching to production only means swapping the token and the provider state.

Secure Token Storage

The Monobank X-Token is stored restricted to system administrators and is never written to the logs.

How it Works
1
The buyer selects plata by mono on the website checkout.
2
Odoo creates an invoice via POST /api/merchant/invoice/create and redirects the buyer to pay.monobank.ua.
3
Monobank sends a signed webhook to /payment/monobank/webhook on every status change.
4
Odoo verifies the signature, updates the transaction, and the buyer returns to /payment/monobank/return → the payment status page.
Status Mapping
Monobank Odoo
createdpending
processingpending
holdauthorized
successdone
failurecanceled
reversedcanceled
expiredcanceled
Installation & Requirements
Install

Apps → search nf_monopay_payment → Install.

Odoo Dependencies

payment, website_sale, account_accountant

Python Packages

cryptography (already in the Odoo venv) and requests

Odoo Version

Odoo 19.0

Configuration
Step 1 — Get a Token
  • Test token: api.monobank.ua (personal cabinet)
  • Production token: web.monobank.ua (merchant cabinet, after enabling Internet Acquiring / plata by mono)
Step 2 — Open the Provider
Go to Accounting → Configuration → Payment Providers and open the plata by mono card.
Payment Providers list — plata by mono
Step 3 — State, Token & Publish
On the provider form set:
  • State → Test Mode (testing) or Enabled (production)
  • Monobank X-Token (Credentials tab) → the token from your Monobank cabinet
  • Published → toggle the provider to Published so it is visible to buyers
Provider form — State, Monobank X-Token and Published toggle
Step 4 — Enable the Payment Method & Set Availability
Open the Configuration tab and click Enable Payment Methods. In the same tab you can restrict availability under Availability:
  • Maximum Amount — if the order total exceeds this value, plata by mono is hidden at checkout
  • Currencies — allowed currencies (supported: UAH, USD, EUR)
  • Countries — allowed countries (leave empty to make it available everywhere)
Configuration tab — Enable Payment Methods and Availability
In the payment methods list, switch the plata by mono method to Active.
Payment Methods list — plata by mono active
Step 5 — Customise Payment Messages
On the Messages tab you can customise the text shown to the buyer at each payment stage — Help, Pending, Done and Cancelled messages.
Messages tab — pending, done and cancelled messages
Step 6 — Public URL (required for webhooks)
Monobank sends webhooks to your website URL, so it must be reachable from the internet. In Settings → Technical → System Parameters → web.base.url set a real public HTTPS URL if it isn't already correct.
Step 7 — Automatic Invoice
Enable Settings → Sales → Invoicing → Automatic Invoice. On a successful payment an invoice is then created and reconciled automatically, and the payment becomes Paid.
FAQ
What is the difference between test and production?

The API URL is the same (https://api.monobank.ua). Only the token differs. To go live: sign an acquiring contract with Monobank, get a production token at web.monobank.ua, replace the token and switch State from Test to Enabled.

How do I test a payment?

In test mode any card number that passes the Luhn algorithm works and no real charge is made. Note: Apple Pay and Google Pay are not available with a test token.

Which currencies are supported?

UAH, USD and EUR. The provider only appears at checkout when the order currency is one of these.

How is webhook authenticity guaranteed?

Each webhook is validated with an ECDSA + SHA256 signature against the Monobank merchant public key. Requests with an invalid signature are rejected.

Which endpoints does the module expose?

/payment/monobank/return (GET) — buyer return after payment, and /payment/monobank/webhook (POST) — status webhooks from Monobank.

Support

Author: Netframe

odoo@netframe.org

For implementation assistance, custom configuration, or any questions — reach out to the Netframe team.

Monobank Acquiring docs: API · Testing · Brandbook 

Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.