PIX Integration

What is PIX Integration?#

PIX integration uses the Mercado Pago Orders API to generate a PIX QR code and copy-paste string (copia e cola) at checkout. The buyer pays in their bank app, and the payment is detected and confirmed automatically - no manual order confirmation.

• Interactive checkout: QR image plus copyable PIX code rendered right in the payment pane
• Automatic confirmation: the order completes itself via Mercado Pago notifications plus a status poll
• Non-custodial: funds settle to your own Mercado Pago account - the platform never touches them
• BRL only: the rail appears on BRL-denominated checkouts

Setup#

1. Create a free account at mercadopago.com.br and create an application to get an access token (TEST-... for testing, APP_USR-... for production).
2. In Settings → PIX, paste the access token and toggle the rail on.
3. Optional: set a webhook secret to enable x-signature verification on PIX notifications.

Testing#

Test mode is fully end-to-end: with test credentials, create a checkout where the payer email is a @testuser.com address and the buyer first name is APRO - Mercado Pago’s sandbox auto-approves the order so you can watch the full confirm flow without real money.

Manual fallback#

The manual PIX bank rail (PIX key, confirmed with Mark as Paid) stays available separately under Bank Payments for merchants without an API token.