PIX is available for one-time payments in BRL. Pass a
billingSessionId to pay() — subscriptions and mandates are not supported.billDetails, so make sure they are set when you create the session.
How the payment completes
On every device (desktop and mobile), the payment popup shows:
- A PIX QR code the customer scans with their banking app.
- A Copy PIX Code button below the QR. The customer can paste this “copia e cola” code into their banking app instead of scanning — the usual choice when paying on the same phone.
tb_pix accepts the same options as qrOptions for UPI QR. They style the QR payment popup, with higher priority than popupConfig. Use the copyButton key to style the copy-code button:
Customize Your SDK -> QR payment popup
View every key supported in qrOptions
PIX Object
Code Snippet for pix component
Using your own button
The component renders a transparent button. To show your own “Pay with PIX” tile, keep the component’s iframe out of sight inside it and callpay() from the tile’s click handler:
- Customize component styles
- Add multiple payment methods using tabs
- Handle payment confirmation on backend
- Set up webhooks for payment status