Why Offer Pix?
Dominant in Brazil
Pix Brazil में सबसे अधिक इस्तेमाल की जाने वाली payment method है, जो credit cards और boleto से आगे है। Central Bank of Brazil की रिपोर्ट के अनुसार, 2025 की दूसरी छमाही में सभी payment transactions में Pix की हिस्सेदारी 54.7% थी।
Instant Settlement
Pix transfers साल के किसी भी दिन और किसी भी समय seconds में पूरी हो जाती हैं, इसलिए bank processing window का इंतज़ार नहीं करना पड़ता।
Low Friction
Customer अपने banking app में QR code स्कैन करता है या Pix code पेस्ट करता है। उसे card numbers या bank details दर्ज करने की आवश्यकता नहीं होती।
Overview
Minimum, BRL के लिए checkout minimum है, इसलिए यह BRL checkout पर हर payment method पर लागू होता है।यह कैसे काम करता है
Customer Experience
- Customer checkout पर Pix चुनता है और Pix CPF field में अपना CPF (11-digit Brazilian taxpayer ID) दर्ज करता है।
- Customer payment की पुष्टि करता है। Pix code और उसके नीचे Copy the code button के साथ एक QR code full-screen overlay में खुलता है।
- Customer अपना banking app खोलता है, Pix चुनता है और QR code स्कैन करता है या Pix code पेस्ट करता है।
- Payment seconds के भीतर confirm हो जाता है।
- Checkout completed payment का पता लगाता है और customer को आपके success page पर redirect करता है।
Pix QR code एक सीमित समय के बाद expire हो जाता है। यदि customer समय पर payment नहीं करता है, तो उसे आपकी site से नया checkout शुरू करना होगा।
Configuration
API Method Type
Testing
1
Enable Test Mode
Dashboard sidebar में Live Mode switch को off करें और test mode में बनाई गई API keys का उपयोग करें।
2
Set Billing Currency to BRL
Adaptive Currency enable करें। फिर
allowed_payment_method_types में billing_currency: 'BRL' और pix के साथ checkout session बनाएं।3
Enter Test CPF and Scan the QR Code
Pix CPF field में
00000000000 (11 zeros) दर्ज करें। Checkout एक test QR code दिखाता है। इसे अपने phone के camera से स्कैन करें; Pix या banking app की आवश्यकता नहीं है। QR code एक test page खोलता है, जहाँ आप successful या failed payment को simulate कर सकते हैं।Best Practices
Set billing currency to BRL
Set billing currency to BRL
Pix केवल BRL में बिल किए गए checkouts पर काम करता है, और Dodo Payments केवल Adaptive Currency enabled होने पर BRL में bill करता है। Adaptive Currency enable करें, ताकि Brazil में customers को BRL में quote और bill किया जा सके।
Provide card fallbacks
Provide card fallbacks
कुछ Brazilian customers card से payment करना पसंद करते हैं। Fallback payment methods के रूप में
credit और debit शामिल करें।Handle QR code expiration
Handle QR code expiration
Pix QR codes एक सीमित समय के बाद expire हो जाते हैं। यदि कोई customer code expire होने के बाद वापस आता है, तो उसके लिए नया checkout session बनाएं।
Troubleshooting
Pix not appearing at checkout
Pix not appearing at checkout
जाँच करें:
- क्या billing currency
BRLहै? - क्या
pixकोallowed_payment_method_typesमें शामिल किया गया है? - क्या customer का billing country Brazil (
BR) है? Adaptive Currency के साथ, Brazilian billing address billing currency को BRL पर set करता है। - क्या Adaptive Currency enabled है?
- क्या amount 0.50 BRL minimum को पूरा करता है?
QR code expired
QR code expired
कारण: Customer ने expiration window के भीतर payment पूरा नहीं किया।समाधान: Customer को आपकी site से नया checkout शुरू करना होगा। उन्हें नया payment link भेजने के लिए, नया checkout session बनाएं।
Payment pending
Payment pending
कारण: अधिकांश Pix payments seconds के भीतर confirm हो जाते हैं, लेकिन कभी-कभी bank transfer में देरी कर सकता है।समाधान: Final payment status के लिए return redirect के बजाय
payment.succeeded और payment.failed webhooks का उपयोग करें। यदि payment कुछ minutes के भीतर confirm नहीं होता है, तो इसे failed मानें।Related Pages
Payment Methods Overview
सभी supported payment methods देखें।
Adaptive Currency
Customers को BRL सहित उनकी local currency में bill करें।
Checkout Guide
Complete checkout implementation guide।
Webhooks
Payment confirmations को asynchronously handle करें।
Testing Process
Test data और checkout testing guidance।