What's new?
We've updated the Paddle platform to support Pix as a payment method. This means that pix is now an allowed value for the payments[].method_details.type field against a transaction in the Paddle API.
Information about the payment method used for a payment attempt.
Type of payment method used for this payment attempt.
pix Pix, a popular payment method in Brazil.
How it works
Brazil is one of the fast-growing emerging market economies, with a population of over 212 million people and an online payment market worth over $3 trillion per year.
Customers in Brazil expect to pay with Pix when buying online. It's the preferred instant payment method for customers in the country, with over 90% of the adult population actively using it.
Pix is now available in early access as a payment method for Paddle Checkout. Once enabled, Paddle automatically presents it as a payment option for one-time purchases in Brazilian Real (BRL) 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.
Before enabling Pix for your live accounts, you should test your checkout success workflows to make sure they're compatible with deferred capture payment methods. Avoid using Paddle.js events for fulfillment workflows.
To keep the Paddle platform safe for everyone, Pix requires additional approval from Paddle. You can apply by emailing sellers@paddle.com. Once approved, you can enable it in Paddle > Checkout > Checkout settings. You don't need to establish a local entity or sign up for any merchant accounts.
You can work with transactions using the API to see the new payments[].method_details.type value.
Summary of changes
| Entity | Field | Change | Type |
|---|---|---|---|
| Transaction | payments[].method_details.type | + Added | Enum value |
| Returns pix. | |||