Accept Pix at checkout

What's new?

We've updated the Paddle platform to support Pix as a payment method. This means that pix is now allowed value for the payments[].method_details.type field against a transaction in the Paddle API.

How it works

Brazil is one of the fast-growing emerging market economies, with a population of over 200 million and an online payment market worth over $500 billion per year. It has its own unique payment landscape, with mobile payment apps like Pix deeply integrated into people's financial lives.

You can now turn on Pix as a payment method for Paddle Checkout. Once enabled, Paddle automatically presents it as a payment option for one-time purchases for customers in Brazil — no additional configuration required.

Deferred capture

Most payment methods supported by Paddle are instant capture type payment methods. This means that payment is authorized and captured in one step.

Pix is a deferred capture type payment method, which means funds are captured after payment is authorized. For Pix, this typically happens within ten minutes, but may take longer in some cases depending on the customer's bank or app.

Paddle Checkout includes a new screen to let customers know that funds are being captured. The checkout is completed at this point, so Paddle.js emits a checkout.completed event.

The transaction is completed when payment is fully captured, at which point a transaction.completed event occurs.

For this reason, we recommend avoiding using Paddle.js events for fulfillment. To be sure a payment was fully captured, use webhooks and wait for transaction.completed to occur.

Next steps

This change is available now.

It's a non-breaking change, meaning it doesn't impact existing integrations. You should test your checkout success workflows to make sure they're compatible with deferred capture payment methods.

You can enable Pix in Paddle > Checkout > Checkout settings. You don't need to establish a local entity or sign up for any merchant accounts.