Home / Blog

Accepting PIX and Boleto in nopCommerce: A Guide for Brazilian Stores

Carlos Casalicchio · Nov 2026 ·6 min read

If you sell online in Brazil, card payments are not enough. Brazilian shoppers expect to pay with PIX, the instant payment system run by the Banco Central do Brasil, and many still use the boleto bancário. This guide explains how both work and how to add them to a nopCommerce store.

How PIX works

PIX is an instant payment system that runs 24 hours a day, every day. At checkout the store shows a QR code and a copy-and-paste code. The customer pays from their banking app, and the money arrives in seconds. For a store, that means faster confirmation than a bank transfer and lower fees than most card payments.

How boleto works

A boleto is a payment slip with a due date and a barcode. Customers pay it in their banking app, at a bank or at authorized payment points. Payment is not instant: it usually clears within one to three business days. Boletos still matter for customers without credit cards and for B2B purchases.

Choosing a gateway

nopCommerce does not talk to the Brazilian payment system directly. A payment gateway such as Pagar.me generates the PIX codes and boletos, receives the payments and notifies your store. When you choose a gateway, compare the fees for PIX, boleto and cards, the payout schedule, and the quality of its API and webhooks.

The checkout flow in nopCommerce

  1. The customer chooses PIX or boleto at checkout.

  2. The payment plugin asks the gateway to create the charge.

  3. The store shows the PIX QR code and copy-and-paste code, or the boleto with its barcode and due date.

  4. The customer pays in their banking app.

  5. The gateway sends a webhook to the store, and the plugin marks the order as paid.

  6. Expired PIX codes and unpaid boletos are cancelled automatically after their due date.

The webhook step matters most. Without it, staff end up checking payments by hand and updating orders one by one.

Shipping with Correios

Payments are only half of selling in Brazil. Customers also expect accurate shipping prices from Correios at checkout. We covered that in Correios API Shipping Done Right.

Our plugins

We maintain nopCommerce plugins for Brazil covering Pagar.me, PIX, boleto and Correios shipping. They install in minutes and are free for up to 10 orders a month. For anything custom, see our nopCommerce development services or contact us.

Want more articles like this?

Subscribe for updates on .NET, Umbraco, nopCommerce, and software engineering.

Get in touch →