Odoo
The IZI Pay - Pagamentos Multicaixa module adds IZI Pay as a payment provider in Odoo eCommerce, with three payment methods:
- Payment by Reference: the customer receives a Multicaixa entity and reference and pays later.
- Multicaixa Express: the customer approves a payment request on their phone.
- QR Code: the customer scans a code with Multicaixa Express.
When a payment is confirmed, Odoo handles the rest as usual: the quotation becomes a sales order, the accounting payment is created, and the order is ready to invoice.
Requirements
- Odoo 19, Community or Enterprise, on Odoo.sh or your own server. Odoo Online can't run third-party modules.
- Angolan kwanza (AOA) available as a currency.
- A public HTTPS address for your Odoo, so IZI Pay can send payment confirmations in production.
- The details listed in What you need from IZI Pay.
Install
- Request the module from IZI Pay support at suporte@izipay.ao, then copy the
izipay_pagamentos_multicaixafolder into your Odoo addons folder. On Odoo.sh, add it to your project's repository. - Restart Odoo.
- Turn on developer mode.
- Open Apps, click Update Apps List, search for IZI Pay - Pagamentos Multicaixa and click Install.
Set up
Open Invoicing → Configuration → Payment Providers → IZI Pay. Menu names here are the English ones; they may be translated if your Odoo uses another language.
1. Choose the environment
Set the provider's state:
- Test Mode uses the sandbox. Start here.
- Enabled uses production. Switch only after your sandbox tests pass and your callbacks are registered.
Each payment stays linked to the environment it was created in. Changing the state later doesn't move existing payments.
2. Enter your credentials
The provider form has a Sandbox profile and a Production profile. Fill in each one with the details IZI Pay gave you for that environment:
| Detail | Needed for |
|---|---|
| Client ID, client secret | All payment methods |
| GPO merchant ID, GPO POS ID, GPO user email | Multicaixa Express and QR Code |
| Supervisor ID | Automatic Multicaixa Express refunds only |
The client ID and secret are required for the environment that's active.
3. Set up callbacks
Callbacks let IZI Pay confirm reference and QR Code payments as soon as they're paid.
- Under Payment by Reference in the provider form, choose a secret value and enter it as the callback Access-Key.
- Copy the two URLs the form shows: PPR Callback URL (
https://your-odoo.com/payment/izipay/ppr/callback) and QR Callback URL (https://your-odoo.com/payment/izipay/qr/callback). - In the IZI Pay Portal, open Definições → Integrações and register those URLs with the same Access-Key (Portal Guide). If you can't register both, ask IZI Pay support.
The module rejects callbacks with a wrong Access-Key, or whose transaction, amount or currency doesn't match. A repeated callback for the same payment is processed only once.
4. Set the reference validity
In the same section, set how many days a reference stays valid, from 1 to 30. The default is 3.
5. Turn on the payment methods and publish
Enable the payment methods your customers should see (Payment by Reference, Multicaixa Express, QR Code). Complete a test checkout in the sandbox, then publish the provider.
What happens at checkout
Payment by Reference
- The customer chooses Payment by Reference and confirms.
- Odoo shows the entity, reference, amount and expiry date, with buttons to copy each value and to print the instructions.
- The order stays pending until IZI Pay confirms the payment, either by callback or by the automatic check that runs every 5 minutes.
- If the reference expires unpaid, the payment is cancelled. The unpaid quotation is also cancelled, unless it has another payment attempt in progress. Confirmed or invoiced orders are never cancelled automatically.
Multicaixa Express
- The customer chooses Multicaixa Express. The module uses the phone number in the customer's details, which must be a nine-digit Angolan number.
- The customer has 60 seconds to approve the request on their phone.
- The result arrives during checkout.
QR Code
- The customer chooses QR Code and Odoo shows a QR Code they can scan, download or print.
- The customer scans it with Multicaixa Express and approves the payment.
- The order is confirmed when the callback arrives, or when you sync its status.
Each QR Code can be paid only once and is valid for 24 hours.
After payment
| IZI Pay result | Odoo payment | Sales order |
|---|---|---|
| Created or processing | Pending | The quotation stays open |
| Completed | Completed | Confirmed and set to To Invoice |
| Failed | Error | Stays open, so you can use Safe Retry |
| Cancelled | Cancelled | Stays open, unless the reference expired |
| Refunded | Refunded or partially refunded | The refund is recorded |
To Invoice without an invoice is normal when Odoo's automatic invoicing is off. Create the invoice from the sales order, or turn automatic invoicing on.
Managing payments
- Sales orders show the IZI Pay payment method, reference, status and expiry. Sync Payment Status in the order header asks IZI Pay for the latest status.
- IZI Pay Operations (Invoicing → Configuration → Online Payments) lists every payment attempt. One order can have several. From an attempt you can:
- check its details, including the QR Code;
- Sync Status with IZI Pay;
- Safe Retry a failed or cancelled payment. This always creates a new attempt and never changes the original;
- Print Instructions for a reference or QR Code;
- open the sales order or the attempt's audit events.
- IZI Pay Audit Log (same menu) records every request to IZI Pay and every callback received, with secrets removed and phone numbers masked.
Operations and the audit log are available to users with Accounting Manager rights.
Refunds
- Multicaixa Express: full and partial refunds are sent through IZI Pay automatically. This needs the Supervisor ID for the environment the payment was made in.
- Payment by Reference and QR Code: the module doesn't refund these automatically.
Troubleshooting
| Problem | What to check |
|---|---|
| The payment was completed but the order isn't confirmed | Open the payment in IZI Pay Operations and click Sync Status. It's safe to repeat. |
| A pending payment hasn't updated | Use Sync Status and look at its events in the IZI Pay Audit Log. References are also checked automatically every 5 minutes. |
| QR Code doesn't appear at checkout | QR Code is enabled, the provider is published, the GPO merchant ID and POS ID are filled in for the active environment, and the order is in AOA. |
| The Operations or Audit Log menu is missing | The user needs Accounting Manager rights. Refresh Odoo after changing them. |