Skip to main content
Use the PIX Component to let a customer pay instantly from their Brazilian bank account with PIX.
PIX is available for one-time payments in BRL. Pass a billingSessionId to pay() — subscriptions and mandates are not supported.
The component collects nothing from the customer. The payer’s name and email are taken from the billing session’s 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.
The popup polls the payment status and switches to the success or failure screen once the customer completes the payment. Component Options 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
Returned Value pix 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 call pay() from the tile’s click handler:
For tb_pix, the frameStyle you pass to create() also sizes the payment popup. Shrink the component with CSS on its mount node, as shown above, rather than with frameStyle: { width: "1px", height: "1px" }. A 1 px frameStyle makes the popup open at its minimum size (320 × 560 px) and overrides the popup size you set in qrOptions or popupConfig.
Next Steps
  • Customize component styles
  • Add multiple payment methods using tabs
  • Handle payment confirmation on backend
  • Set up webhooks for payment status
Need Help? Explore the following sections for more details: If you need assistance, our support team is here to help 🚀