دمج SDK لـ React Native
يمكنك من خلال Dodo Payments React Native SDK بناء تجارب دفع آمنة في تطبيقات Android و iOS الأصلية الخاصة بك. يوفر SDK مكونات واجهة مستخدم قابلة للتخصيص وشاشات لجمع تفاصيل الدفع.- 📦 قم بتثبيت SDK الخاص بنا من NPM
- 📚 عرض مستودع العرض التوضيحي للحصول على أمثلة تنفيذ كاملة
- 🎥 شاهد فيديو العرض التوضيحي لرؤية Dodo Payments SDK في العمل
الميزات
Simplified Security
اجمع بيانات الدفع الحساسة بأمان مع الالتزام بمتطلبات PCI
Multiple Payment Methods
اقبل طرق الدفع المتنوعة لتوسيع التواجد العالمي
Native UI
شاشات وعناصر أصيلة لأندرويد وiOS
حاليًا، Apple Pay وGoogle Pay وCash App وUPI غير مدعومة في SDK ريأكت نيتيف. نحن نعمل بنشاط لإضافة دعم لهذه طرق الدفع في الإصدارات القادمة.
التثبيت
1
Install the SDK
قم بتثبيت SDK من Dodo Payments باستخدام مدير الحزم المفضل لديك:
- npm
- yarn
2
Platform-specific setup
- iOS
- Android
قم بتشغيل pod install في مجلد iOS الخاص بك:
إعداد جانب العميل
1
Get Publishable Key
احصل على مفتاح النشر من لوحة تحكم Dodo Payments. (مختلف لكل من وضعي الاختبار والحي)
https://app.dodopayments.com/developer/others
2
Setup Payment Provider
قم بتغليف تطبيقك بـ
DodoPaymentProvider:App.tsx
ستحتاج إلى إنشاء مفاتيح API من لوحة تحكم Dodo Payments. راجع دليل إنشاء مفاتيح API للحصول على تعليمات مفصلة.
3
Create payment utility function
أنشئ دالة مساعدة لجلب معلمات الدفع من واجهة برمجة التطبيقات الخلفية الخاصة بك:
utils/fetchPaymentParams.ts
تفترض هذه الدالة وجود نقطة نهاية في الواجهة الخلفية تنشئ نوايا دفع وتعيد السر الخاص بالعميل. تأكد من تكوين الواجهة الخلفية بشكل صحيح للتعامل مع إنشاء الدفع. راجع دليل تكامل API لأمثلة إعداد الواجهة الخلفية.
4
Implement the payment screen
أنشئ شاشة الدفع الخاصة بك باستخدام هوك
useCheckout. فيما يلي تنفيذ كامل:PaymentScreen.tsx
للحصول على أمثلة كاملة مع التنسيق والتعامل مع الأخطاء وخيارات التخصيص، اطلع على مستودعات العرض التوضيحي:
خيارات التكوين
معلمات الجلسة
سر العميل من نية الدفع، يتم الحصول عليه من واجهة One time payment أو الاشتراك.
وضع جلسة الدفع (تجريبي أو حي).
خيارات التخصيص لمظهر صفحة الدفع
وضع السمة:
'light' أو 'dark'تخصيص المظهر
يمكنك تخصيص تجربة الدفع الموحدة في React Native لتتناسب مع تصميم تطبيقك عن طريق تعديل الألوان والخطوط والمزيد من خلال معلمة appearance عند استدعاءinitPaymentSession().
تخصيص الألوان
تحدد كل فئة لون لون مكون واحد أو أكثر في واجهة المستخدم. على سبيل المثال،primary يحدد لون زر الدفع.
مثال على التكوين مع دعم للوضعين الفاتح والداكن:
تخصيص الشكل
يمكنك تخصيص نصف قطر الحدود، وعرض الحدود، والظل المستخدم في جميع أنحاء واجهة الدفع:تخصيص مكونات محددة
يمكنك تخصيص مكونات واجهة المستخدم المحددة مثل الزر الأساسي (زر الدفع). تأخذ هذه الإعدادات الأولوية على إعدادات المظهر العامة:معالجة الأخطاء
تعامل مع حالات الدفع المختلفة في دالة الخروج الخاصة بك:Common Error Scenarios
Common Error Scenarios
- مشكلات الاتصال بالشبكة: تأكد من وجود اتصال إنترنت مستقر
- سر العميل غير صالح: تحقق من أن الواجهة الخلفية تولّد نوايا دفع صالحة
- الاعتمادات المفقودة: ثبّت جميع الاعتمادات المطلوبة
- الإعداد الخاص بالمنصة: اكمل خطوات تكوين iOS وAndroid
- أخطاء API: راجع مرجع رموز الأخطاء للتعامل المفصل مع الأخطاء
Debugging Tips
Debugging Tips
- تمكين تسجيل التصحيح في التطوير
- تحقق من الطلبات الشبكية إلى الخلفية
- تأكد من تكوين مفاتيح API بشكل صحيح
- اختبار على منصات iOS و Android
- راجع الأسئلة الشائعة الفنية للمشاكل الشائعة
- استخدم وضع الاختبار مقابل الوضع المباشر بشكل مناسب