React Native SDK एकीकरण
Dodo Payments React Native SDK आपको अपने मूल Android और iOS ऐप्स में सुरक्षित भुगतान अनुभव बनाने की अनुमति देता है। हमारा SDK भुगतान विवरण एकत्र करने के लिए अनुकूलन योग्य UI घटक और स्क्रीन प्रदान करता है।- 📦 हमारे SDK को NPM से स्थापित करें
- 📚 पूर्ण कार्यान्वयन उदाहरणों के लिए हमारे डेमो रिपॉजिटरी को देखें
- 🎥 Dodo Payments SDK को क्रियान्वित होते हुए देखने के लिए हमारा डेमो वीडियो देखें
विशेषताएँ
Simplified Security
PCI अनुपालन बनाए रखते हुए संवेदनशील भुगतान डेटा को सुरक्षित रूप से एकत्र करें
Multiple Payment Methods
वैश्विक पहुँच बढ़ाने के लिए विभिन्न payment methods स्वीकार करें
Native UI
Android और iOS के लिए मूल स्क्रीन और तत्व
वर्तमान में, React Native SDK में Apple Pay, Google Pay, Cash App, और UPI समर्थित नहीं हैं। हम इन भुगतान विधियों के लिए भविष्य के रिलीज़ में समर्थन जोड़ने पर सक्रिय रूप से काम कर रहे हैं।
स्थापना
1
Install the SDK
अपने पसंदीदा पैकेज मैनेजर का उपयोग करके Dodo Payments SDK इंस्टॉल करें:
- npm
- yarn
2
Platform-specific setup
- iOS
- Android
अपनी iOS फ़ोल्डर में pod install चलाएँ:
क्लाइंट-साइड सेटअप
1
Get Publishable Key
Dodo Payments डैशबोर्ड से अपना publishable key प्राप्त करें। (टेस्ट और लाइव मोड दोनों के लिए अलग-अलग)
https://app.dodopayments.com/developer/others
2
Setup Payment Provider
DodoPaymentProvider के साथ अपने ऐप को रैप करें:App.tsx
आपको अपने Dodo Payments डैशबोर्ड से API कीज़ उत्पन्न करनी होंगी। विस्तृत निर्देशों के लिए हमारी API key generation guide देखें।
3
Create payment utility function
अपनी backend API से भुगतान पैरामीटर प्राप्त करने के लिए एक उपयोगिता फ़ंक्शन बनाएं:
utils/fetchPaymentParams.ts
यह फ़ंक्शन मानता है कि आपके पास एक backend API endpoint है जो payment intents बनाता है और एक client secret लौटाता है। सुनिश्चित करें कि आपका backend भुगतान निर्माण को संभालने के लिए ठीक से कॉन्फ़िगर किया गया है। बैकएंड सेटअप उदाहरणों के लिए हमारी API Integration Tutorial देखें।
4
Implement the payment screen
useCheckout हुक का उपयोग करके अपनी भुगतान स्क्रीन बनाएं। यहाँ एक पूर्ण कार्यान्वयन है:PaymentScreen.tsx
स्टाइलिंग, त्रुटि हैंडलिंग, और अनुकूलन विकल्पों के साथ पूर्ण उदाहरणों के लिए हमारे डेमो रिपॉजिटरी देखें:
कॉन्फ़िगरेशन विकल्प
सत्र पैरामीटर
आपकी भुगतान मंशा से प्राप्त client secret, जिसे वन टाइम पेमेंट या सब्सक्रिप्शन API से प्राप्त किया गया है।
भुगतान सत्र का मोड (test या live)।
भुगतान शीट की उपस्थिति के लिए अनुकूलन विकल्प
थीम मोड:
'light' या 'dark'उपस्थिति अनुकूलन
आप appearance पैरामीटर को संशोधित करके React Native Unified Checkout को अपने ऐप की डिज़ाइन के अनुरूप अनुकूलित कर सकते हैं जब आपinitPaymentSession() को कॉल करते हैं।
रंग अनुकूलन
प्रत्येक रंग श्रेणी UI में एक या अधिक घटकों का रंग निर्धारित करती है। उदाहरण के लिए,primary Pay बटन का रंग निर्धारित करता है।
हल्का और गहरा मोड समर्थन के साथ उदाहरण कॉन्फ़िगरेशन:
आकार अनुकूलन
आप भुगतान इंटरफ़ेस में उपयोग किए जाने वाले सीमा त्रिज्या, सीमा चौड़ाई, और छाया को अनुकूलित कर सकते हैं:घटक-विशिष्ट अनुकूलन
आप प्राथमिक बटन (भुगतान बटन) जैसे विशिष्ट UI घटकों को अनुकूलित कर सकते हैं। ये सेटिंग्स वैश्विक उपस्थिति सेटिंग्स पर प्राथमिकता लेती हैं:त्रुटि हैंडलिंग
अपने चेकआउट फ़ंक्शन में विभिन्न भुगतान राज्यों को संभालें:Common Error Scenarios
Common Error Scenarios
- Network connectivity issues: सुनिश्चित करें कि इंटरनेट कनेक्शन स्थिर है
- Invalid client secret: सत्यापित करें कि बैकएंड मान्य भुगतान मंशाएँ उत्पन्न कर रहा है
- Missing peer dependencies: सभी आवश्यक निर्भरताएँ इंस्टॉल करें
- Platform-specific setup: iOS और Android कॉन्फ़िगरेशन चरणों को पूरा करें
- API errors: विस्तृत त्रुटि हैंडलिंग के लिए हमारे Error Codes Reference को देखें
Debugging Tips
Debugging Tips
- विकास में डिबग लॉगिंग सक्षम करें
- अपने बैकएंड के लिए नेटवर्क अनुरोधों की जांच करें
- सुनिश्चित करें कि API कुंजियाँ सही ढंग से कॉन्फ़िगर की गई हैं
- iOS और Android दोनों प्लेटफार्मों पर परीक्षण करें
- सामान्य समस्याओं के लिए हमारे Technical FAQs की समीक्षा करें
- Test vs Live Mode का उपयुक्त रूप से उपयोग करें