Receive Pix payments
Create a charge, present the QR Code and confirm payment through a webhook.
A reliable Pix flow has three parts: charge creation, payment presentation and asynchronous confirmation.
1. Create the charge
Call POST /v1/payments with an integer amount in cents, customer context and a stable idempotency key.
2. Present both payment options
Use the returned QR Code on desktop and show the copy-and-paste code for mobile users. Display the amount and order description next to the payment.
3. Wait for confirmation
Keep the order pending until your server validates a payment webhook. A browser redirect or a customer clicking “I paid” is not proof of payment.
4. Handle expiration and retries
If a charge expires, create a new charge with a new business-operation key. Never silently change the amount attached to an existing payment.
Security
Validate the webhook signature and amount before releasing a product or crediting an account.