الانتقال إلى المحتوى الرئيسي
يوفر SDK روبي طريقة بسيطة وبديهية لدمج مدفوعات دودي في تطبيقات روبي الخاصة بك. يتبع تقاليد روبي وأفضل الممارسات، ويقدم معالجة شاملة للأخطاء، والترقيم، ودعم البرمجيات الوسيطة.

التثبيت

أضف الجوهرة إلى ملف Gemfile الخاص بك:
Gemfile
استخدم دائمًا أحدث إصدار من SDK للوصول إلى أحدث ميزات Dodo Payments. شغّل bundle update dodopayments بانتظام للبقاء على اطلاع.
ثم قم بتشغيل:
يدعم الـ SDK روبي 3.2.0 والإصدارات الأحدث، مع أنواع شاملة، ومعالجة أخطاء، وآليات إعادة المحاولة.

البداية السريعة

قم بتهيئة العميل وإنشاء جلسة دفع:
قم بتخزين مفاتيح API بأمان باستخدام متغيرات البيئة. لا تقم أبدًا بالتزامن بها إلى نظام التحكم بالإصدار أو كشفها في الشيفرة.

الميزات الأساسية

Ruby Conventions

يتبع اصطلاحات التسمية في روبي والأنماط الاصطلاحية

Elegant Syntax

واجهة برمجة تطبيقات نظيفة وقابلة للقراءة تبدو طبيعية لمطوّري روبي

Auto-Pagination

مُكرِّرات التصفح التلقائي المدمجة لردود القوائم

Type Safety

أنواع Sorbet الاختيارية لتعزيز أمان النوع

التكوين

تكوين المهلة

قم بتكوين مهلات الطلبات:

تكوين إعادة المحاولة

قم بتكوين سلوك إعادة المحاولة التلقائي:

العمليات الشائعة

إنشاء جلسة دفع

قم بإنشاء جلسة دفع:

إدارة العملاء

قم بإنشاء واسترجاع معلومات العملاء:

التعامل مع الاشتراكات

قم بإنشاء وإدارة الاشتراكات المتكررة:
billing يتطلب على الأقل رمز ISO ذو الحرفين country . customer يقبل إما { customer_id: "..." } لإرفاق عميل موجود أو { email: "...", name: "..." } لإنشاء عميل جديد. product_price في أدنى فئة عملة.

الصفحات

التصفح التلقائي

التنقل تلقائيًا عبر جميع الصفحات:

التصفح اليدوي

للحصول على مزيد من التحكم في التصفح:

معالجة الأخطاء

تعامل مع أخطاء Dodo Payments API المختلفة:
قم بتنفيذ منطق المحاولة مرة أخرى مع تأخير متزايد لمعالجة أخطاء حد المعدل لضمان تعامل تطبيقك بسلاسة مع السيناريوهات ذات الحجم الكبير.

أمان الأنواع مع Sorbet

استخدم Sorbet للحصول على معلمات طلب آمنة الأنواع:

الاستخدام المتقدم

نقاط النهاية غير الموثقة

إجراء طلبات إلى نقاط نهاية غير موثقة:

معلمات غير موثقة

إرسال معلمات غير موثقة:

تكامل Rails

إنشاء مبدئي

إنشاء config/initializers/dodo_payments.rb:

نمط كائن الخدمة

إنشاء خدمة دفع:

تكامل وحدة التحكم

استخدم في وحدات تحكم Rails الخاصة بك:

تكامل Sinatra

استخدام مع تطبيقات Sinatra:

الموارد

GitHub Repository

عرض كود المصدر والمساهمة

API Reference

وثائق API الكاملة

Discord Community

الحصول على المساعدة والتواصل مع المطورين

Report Issues

الإبلاغ عن أخطاء أو طلب ميزات

الدعم

تحتاج إلى مساعدة في Ruby SDK؟

المساهمة

نرحب بالمساهمات! تحقق من إرشادات المساهمة للبدء.
آخر تعديل في ٢٨ مايو ٢٠٢٦