Issue and manage refunds
Last updated: Sept 11th, 9:32am
You can issue refunds on any paid Pix QR code up to 90 days after settlement. You can generate multiple refunds if the total amount doesn't exceed the original settled QR code amount and you have sufficient Pix balance to cover the refunds.
Pix refunds operate separately from card transactions. You cannot combine or use a card balance for Pix refunds. Refunds remain pending when you don't have sufficient Pix balance until adequate money becomes available.
Refund requirements
- You can issue refunds up to 90 days after the buyer settles the Pix QR code.
- The total amount refunded cannot exceed the original QR code amount.
- You can issue multiple refunds if they do not exceed the original amount.
- You must have a sufficient Pix balance before you process refunds90 days maximum after the Pix QR code was settled.
For sufficient balance
Refund processes immediately
For insufficient balance
- Refunds are not processed if your Pix balance is insufficient.
- You must ensure your Pix balance covers the refund amount before issuing a refund.
Example Scenarios
- Insufficient money: A merchant with a 100 BRL balance cannot process a 110 BRL refund until the balance reaches at least 110 BRL
- Priority processing: If pending refunds are 20 BRL, 10 BRL, and 50 BRL, and the merchant receives a 15 BRL settlement, PayPal processes only the 10 BRL refund
How to issue refunds
You can issue refunds for Pix payments using:
- PayPal Refunds API
- Activity page in PayPal developer dashboard
To refund a Pix payment using APIs, send a POST request to the /v2/payments/captures/{capture_id}/refund endpoint. The capture_id can be found in the purchase_units/payments/captures/id field of the original order.