PagSeguro & PagBrasil Gateway (Brazil)

Key Features

Accepts credit and debit cards, Pix (QR + copy-paste), and Boleto Bancario through PagSeguro and/or PagBrasil

Card installments (parcelamento) with configurable max installments, minimum amounts and interest rules

BRL settlement against your own PagSeguro/PagBrasil acquiring contract and rates

OAuth-authenticated API connection scoped to your acquirer account

Webhooks for asynchronous Pix and Boleto confirmation, with idempotent handling of duplicate notifications

Order, payment status and acquirer transaction IDs reconciled into Shopify via the Admin GraphQL API

Payment method, installment terms and gateway transaction reference written to order metafields for reporting

CPF/CNPJ capture and validation at checkout where the acquirer requires it

Anti-fraud screening signals forwarded to the gateway's risk engine

Refunds, partial refunds and voids triggered directly from the Shopify order

Pending Boleto orders hold inventory and auto-cancel on expiry, releasing stock

Reconciliation export aligning Shopify orders with acquirer settlement and installment captures

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

You order

Start with a one-time build price. We scope it with you at kickoff.

We build & install

ECOSIRE builds, configures and installs it on your Shopify.

Go live + support

You go live in about 2–4 weeks, with a post-launch support window.

About this Product

PagSeguro and PagBrasil are two of Brazil's most established acquirers, and Brazilian shoppers recognize and trust them at checkout. This is a build-to-order Shopify integration — ECOSIRE builds, installs and supports it for your store. It is not an instant App Store download; we configure it to your acquirer account, themes and order flow, then hand it over working.

The integration accepts the payment methods Brazilian customers actually use: credit and debit cards, Pix (with QR code and copy-paste codes), Boleto Bancário, and card installments (parcelamento) with the rules you set. Settlement is in BRL against your own PagSeguro/PagBrasil contract — your money, your acquiring rates.

Under the hood we wire your Shopify store to the acquirer using OAuth for authenticated API access, register webhooks for asynchronous payment confirmations (Pix and Boleto clear minutes-to-hours after order placement), and reconcile each transaction back to the Shopify order via the Admin GraphQL API. Payment status, acquirer transaction IDs and installment terms are written to order metafields so your reconciliation, fulfillment and reporting stay accurate.

We handle the realities of Brazilian checkout: CPF/CNPJ capture where the acquirer requires it, anti-fraud screening signals passed through to the gateway, refunds and cancellations triggered from Shopify, and clean reconciliation of multi-installment captures. Pending Boletos hold inventory correctly and auto-cancel on expiry.

You get a working integration matched to your catalog and theme, plus documentation and support after launch. If PagSeguro or PagBrasil change an API or webhook contract, we maintain the integration under your support plan.

What you get

Custom-built PagSeguro/PagBrasil integration installed and configured on your Shopify store

OAuth connection and webhook endpoints registered and verified against your acquirer account

Checkout configuration for cards, Pix, Boleto and installment rules matched to your catalog

Order metafield schema for payment status, transaction IDs and installment terms

Reconciliation and refund flow wired into the Shopify Admin

Sandbox/test-mode validation run before go-live, with a documented test plan

Handover documentation covering configuration, webhooks and day-to-day operation

Post-launch support and maintenance under your chosen plan

Who this is for

Brazil-focused store owner

Sells to Brazilian customers and wants a trusted local acquirer beyond Mercado Pago, with Pix and Boleto that shoppers already recognize.

Finance and reconciliation lead

Needs each Shopify order matched to acquirer settlement, installment captures reconciled, and refunds traceable end to end in BRL.

Cross-border merchant entering Brazil

Operating outside Brazil but launching a Brazilian storefront, needing local payment methods, CPF/CNPJ handling and installments configured correctly the first time.

How PagSeguro & PagBrasil Gateway (Brazil) Compares

Criterion	ECOSIRE	Custom Build	Competitor
Local Brazilian methods (Pix, Boleto, installments) configured to your catalog	Included	Partial support	Partial support
BRL settlement on your own PagSeguro/PagBrasil acquiring contract	Included	Included	Partial support
Built, installed and configured for you (no DIY assembly)	Included	Not included	Not included
Webhook reconciliation for async Pix/Boleto into Shopify orders	Included	Partial support	Partial support
Installment (parcelamento) rules with custom min amounts and interest	Included	Partial support	Partial support
Instant self-serve availability with zero lead time	Not included	Not included	Included
Direct support and maintenance when acquirer APIs change	Included	Not included	Partial support
Order metafields for payment status, transaction IDs and installment terms	Included	Partial support	Not included

Frequently Asked Questions about PagSeguro & PagBrasil Gateway (Brazil)

How long does it take to build and install?

This is a build-to-order integration with a typical lead time of about 2 to 3 weeks from the day you provide PagSeguro/PagBrasil account access and checkout requirements. We confirm a firm date during kickoff. Complex installment or anti-fraud rules can extend it slightly; we tell you upfront rather than after starting.

Is this an instant Shopify App Store download?

No. ECOSIRE builds, installs and configures the integration specifically for your store, acquirer contract and theme. There is no instant self-serve download — that is intentional, because Pix, Boleto and installment rules need to be wired to your actual catalog and acquirer account to work correctly.

Do I need my own PagSeguro or PagBrasil account?

Yes. Settlement happens in BRL against your own acquiring contract, so your acquiring rates and funds stay yours. We connect the integration to your account via OAuth and configure the credentials; we do not resell or sit in the middle of your payments.

What happens for ongoing support and updates?

After launch you get a support plan covering bug fixes, configuration help and maintenance. If PagSeguro or PagBrasil change an API version or webhook contract, we update the integration so it keeps working. Support requests are handled directly by ECOSIRE, not a third party.

How are Pix and Boleto confirmations handled if the customer pays later?

Both clear asynchronously. We register webhooks so when the customer completes a Pix transfer or pays a Boleto — which can be hours later — the gateway notifies your store, the Shopify order is marked paid via the Admin GraphQL API, and fulfillment can proceed. Pending Boletos hold inventory and auto-cancel on expiry.

Can you support both PagSeguro and PagBrasil, or just one?

Either. Some merchants use a single acquirer; others want PagBrasil for one method set and PagSeguro for another. We scope which acquirer handles which method during kickoff and build to that. Adding the second acquirer later is supported under your plan.