Skip to main content
يوفر SDK روبي طريقة بسيطة وبديهية لدمج مدفوعات دودي في تطبيقات روبي الخاصة بك. يتبع تقاليد روبي وأفضل الممارسات، ويقدم معالجة شاملة للأخطاء، والترقيم، ودعم البرمجيات الوسيطة.

التثبيت

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

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

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

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

Ruby Conventions

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

Elegant Syntax

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

Auto-Pagination

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

Type Safety

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

التكوين

تكوين المهلة

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

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

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

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

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

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

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

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

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

قم بإنشاء وإدارة الاشتراكات المتكررة:
POST /subscriptions (the SDK’s subscriptions.create method) مهمل. لا يزال يعمل مع عمليات التكامل الحالية، ولكن يجب أن تنشئ عمليات التكامل الجديدة الاشتراكات من خلال Checkout Session.
يتطلب billing، كحد أدنى، رمز ISO مكوّنًا من حرفين country. يقبل customer إما { customer_id: "..." } لإرفاق عميل حالي أو { email: "...", name: "..." } لإنشاء عميل جديد. تكون قيمة product_price بأدنى فئة من فئات العملة.

الترقيم

الترقيم التلقائي

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

الترقيم اليدوي

لمزيد من التحكم في الترقيم:

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

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

أمان الأنواع باستخدام Sorbet

استخدم Sorbet لمعلمات الطلبات الآمنة من حيث النوع:

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

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

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

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

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

التكامل مع Rails

إنشاء Initializer

أنشئ config/initializers/dodo_payments.rb:

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

أنشئ خدمة للدفع:

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

استخدمه في وحدات تحكم Rails لديك:

التكامل مع Sinatra

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

الموارد

GitHub Repository

عرض التعليمات البرمجية المصدرية والمساهمة

API Reference

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

Discord Community

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

Report Issues

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

الدعم

هل تحتاج إلى مساعدة بشأن Ruby SDK؟

المساهمة

نرحب بالمساهمات! راجع إرشادات المساهمة للبدء.
آخر تعديل في ١٧ أغسطس ٢٠٢٦