Black November: −35% on all modules until 30 November Black November: −35% until 30 November Choose a module

Get in touch
OpenCart

iugu for OpenCart (Pix, boleto, card)

iugu for OpenCart 4.x, 3.x, 2.3 (Brazil): Pix and boleto through an iugu invoice; Pro adds cards with instalments, webhooks, refunds, split, a payments list. Licence for life.

Pro · lifetime licence Staging copies are included. The more sites, the cheaper each one
Compatibility
OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · module language: English, Português (Brasil)
PHP
7.0 or newer
Version
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3)
Licence
a site + a staging copy, lifetime
Trial
7 days, no card, one per site
Updated
16.11.2026
Or all 509 Pro modules with All Access — 3 244 UAH / year ≈ €66

What Free has,
and what Pro adds

The free version works with no time limit. Pro adds the rest of the features in the table.

Feature Free Pro
Pix and boleto through an iugu invoice, chosen at checkout ✔ ✔
CPF or CNPJ: typed by the shopper or taken from a store field, check digits verified ✔ ✔
Order awaiting payment with the payment link in the history and the e-mail ✔ ✔
Status on the shopper's return from iugu and a "Check status at iugu" button ✔ ✔
Teste and Produção environments, connection check, encrypted tokens ✔ ✔
Order statuses, title per language, due date, geo zone ✔ ✔
Card payments at checkout through iugu.js, 2 to 12 instalments — ✔
Automatic statuses from iugu's webhooks and a background check — ✔
Invoice cancelled together with the order — ✔
Cancel and refund from the order (card: also in part) — ✔
Split of every invoice with another iugu account — ✔
Payments list with filters, totals and CSV export — ✔

What it looks like

Choosing the way to pay at checkout
The order summary in reais, the choice of Pix, boleto or card, the CPF or CNPJ field and the “Continue with iugu” button.
Card payment at checkout (Pro)
The card fields that go straight to iugu and the choice of instalments from 1x to 12x.
Page while the payment is awaited
The order is placed and waits for the payment: the boleto line, “Open the payment page” and “Check again”.

Key points

What the shopper and the store get

At checkout the shopper chooses Pix, boleto or (in Pro) a card. The CPF or CNPJ is typed by the shopper or taken by the module from a custom field of the store; the check digits are verified, so a wrong number never reaches iugu.

What is in the admin

Extensions → Extensions → Payments → iugu by CatCode: tabs for the connection, checkout, order statuses, Pro and the log.

The trial starts when you ask

A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy

Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.

Technical requirements

  • OpenCart 4.0.2.x–4.1.x, 3.0.x or 2.3.0.2; PHP 7.0+ for 2.3, the cURL extension.
  • An iugu account and API tokens from the Alia dashboard are required. For live payments iugu requires verification of the merchant company in Brazil (CNPJ).
  • Payment currency: BRL. If the session currency is different or the total is below R$ 1.00, the method is not offered at checkout.
  • A boleto needs the payer’s full address: CEP, street and house number in the address_1 field as “Rua X, 123”. Without them iugu rejects the invoice and the shopper sees a message about the address.
  • The free version does not receive webhooks: a boleto paid later is updated only with the “Check status at iugu” button or when the shopper returns to the site. Automatic statuses through webhooks and the cron check are Pro.
  • The order is placed as “awaiting payment” before the payment, so unpaid Pix and boleto stay in the order list until the store cancels them or (in Pro) iugu reports the expiry.
  • Card payments need the Account ID (32 characters from Alia → Configurações → Informações da Conta). An ad blocker in the shopper’s browser blocks iugu.js, and the shopper then sees a message about it. Instalments start at R$ 5 a month; the instalment fees are set in the iugu account.
  • iugu subscriptions and plans are not supported: the module takes a one-off payment for the order.

Version history

v1.0.0 Current 16.11.2026

For OpenCart 4.x, 3.x and 2.3: Pix and boleto through an iugu invoice, CPF/CNPJ with check digits, the order awaiting payment with the payment link, status on the shopper’s return and by a…

Frequently bought with iugu

All Access Need more? All modules (509) under one licence, new ones are added automatically. 3 244 UAH≈ €66 Learn more →

Full module description

iugu by CatCode for OpenCart 4.x, 3.x and 2.3 takes Pix and boleto payments in Brazilian reais through an iugu invoice (fatura) with your own iugu account. The shopper picks the way to pay at checkout, enters a CPF or CNPJ and goes to iugu’s payment page with the Pix QR code or the boleto.

What the shopper and the store get

At checkout the shopper chooses Pix, boleto or (in Pro) a card. The CPF or CNPJ is typed by the shopper or taken by the module from a custom field of the store; the check digits are verified, so a wrong number never reaches iugu. The invoice is created with the order total in cents, the payer’s data (name, phone, address, CEP) and the due date you set in the settings.

The order is placed as “awaiting payment”, the cart is emptied, and the payment link (for a boleto also the line to pay in the bank app) sits in the order history and in the customer’s e-mail. The shopper is taken to iugu’s page; if they come back without paying, they see an “order waits for the payment” page with the “Open the payment page” and “Check again” buttons.

The module reads the invoice status at iugu and follows iugu’s table of status transitions: a late or repeated answer never undoes a payment that is already booked, and if the paid amount differs from the order, the status stays and a note is left. Two clicks on “Continue with iugu” at the same moment give one invoice, not two.

If iugu is unreachable, answers with an error or rejects the address, the shopper sees a short, clear message, no order is created and the cart stays; the details go to the attempts log.

What is in the admin

Extensions → Extensions → Payments → iugu by CatCode: tabs for the connection, checkout, order statuses, Pro and the log. In iugu (Alia → Configurações → Integrações API) create a token of type Teste and one of type Produção, paste them, choose the environment and press “Check connection”: the module shows whether iugu accepted the token and how many invoices the account has. Tokens are stored encrypted and never shown on the page; an empty field keeps the saved token.

Checkout settings: method title and text for every store language, due date, geo zone, sort order, and the order statuses for “awaiting payment”, “paid”, “cancelled”, “expired” and “refunded”. The module interface is in English and Portuguese (Brazil).

The iugu tab on the order page lists the invoices with the way of payment, state, amount and the event log of each one, and “Check status at iugu” reads the invoice again. In Pro the same tab cancels an invoice and refunds (a card also in part). The payments list with filters, totals and CSV export opens from the settings.

Without a licence the Pro fields are shown disabled with an explanation, and saved Pro values are not sent to iugu. The “Try Pro” button starts a 7-day trial.

How it works, step by step

  1. Install the archive for your OpenCart version and install the method under “Payments”.
  2. In iugu create API tokens (Teste and Produção) and paste them on the connection tab.
  3. Choose the environment, enter the Account ID (for cards) and press “Check connection”.
  4. Set the method title, the due date and the order statuses.
  5. Place an order in BRL, choose Pix or boleto, enter a CPF or CNPJ and press “Continue with iugu”.
  6. In Pro add the webhook address in iugu (Gatilhos) or call the cron URL from the settings.

Under the hood

  • iugu API v1: invoices, cancel, refund, card charge with an iugu.js token; account-token authentication.
  • Card data never reaches the store: iugu.js turns it into a one-time token in the shopper’s browser and only the token goes to the server.
  • iugu’s webhooks carry no signature, so the body of a webhook is not trusted: the module reads the invoice again at iugu and applies only its real state; a forged message changes nothing. The webhook URL is signed.
  • Every state change runs under a lock on the invoice: parallel copies of a webhook give one record, and a late status never rolls back a newer one.
  • Tokens are stored encrypted; the module log contains no tokens, card data, e-mail, name, phone, address or full CPF.
  • The background check of open invoices works in Pro only, in portions, and covers the cases when a webhook did not arrive.
  • Interface in English and Portuguese (Brazil).

Installation

  1. OpenCart 4: Extensions → Installer, upload cc_iugu.ocmod.zip without renaming it.
  2. OpenCart 3.x: Extensions → Installer, upload cc_iugu-oc3.ocmod.zip, then Extensions → Modifications → Refresh.
  3. OpenCart 2.3: Extensions → Installer, upload cc_iugu-oc2.ocmod.zip (FTP settings in System → Settings → FTP are required; otherwise unpack the archive and upload the contents of the upload/ folder to the store root by hand), then Extensions → Modifications → Refresh.
  4. Extensions → Payments → iugu by CatCode: install it and open the settings.
  5. Paste the API tokens, choose the environment and press “Check connection”.
  6. For Pro: paste the licence key or start the trial on the “Pro” tab.

Questions
about the module

Didn't find the answer? Message us on Telegram and we'll reply within a business day.

@catcode_support Setup, compatibility, activation
Is this the official iugu module?

No, it is an independent integration through iugu's public API. iugu is a trademark of its owner.

Where do I get the API tokens?

In the iugu dashboard (Alia): Configurações → Integrações API. Create a token of type Teste for trial payments and Produção for live ones.

Which ways to pay are there?

Pix and boleto in the free version, a credit card with 2 to 12 instalments in Pro.

Does card data pass through my site?

No. iugu.js in the shopper's browser creates a one-time token, and only that goes to your server.

What if the shopper paid with Pix but did not return to the site?

In Pro iugu's webhook and the background check change the order status by themselves. In the free version the "Check status at iugu" button on the order updates it.

Why is a boleto rejected?

iugu requires the payer's full address: CEP, street and number. The module takes the number from the address_1 field ("Rua X, 123"); if it is missing, the shopper sees a message about the address and no order is created.

Can I refund?

Yes, in Pro: a refund from the order page, for a card also in part.

Which currencies are supported?

BRL only. In another currency the method is not shown at checkout.

Which OpenCart versions are supported?

OpenCart 4.0.2.x–4.1.x, 3.0.x and 2.3.0.2: three separate archives in one product.

Is the licence for life?

Yes, for OpenCart it is one payment and a licence for life, valid on two sites.

What happens after the trial?

Pro switches off, the free part keeps working.

Not quite what you are looking for?

We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.

Order a custom module