الانتقال إلى المحتوى الرئيسي
يوفر SDK جافا وصولاً مريحًا وسهل الاستخدام إلى واجهة برمجة تطبيقات REST الخاصة بمدفوعات دودي للتطبيقات المكتوبة بلغة جافا. يستخدم ميزات محددة لجافا مثل Optional وStream وCompletableFuture لتطوير جافا الحديث.

التثبيت

Maven

أضف التبعية إلى pom.xml:
pom.xml

Gradle

أضف التبعية إلى build.gradle:
build.gradle.kts
استخدم دائمًا أحدث إصدار من مجموعة SDK للوصول إلى أحدث ميزات Dodo Payments. تحقق من Maven Central لأحدث إصدار.
تدعم مجموعة SDK Java 8 وكل الإصدارات الأحدث، بما في ذلك Java 11 و17 و21.

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

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

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

Type Safety

واجهة برمجة تطبيقات من نوع ثابت مع ضمان السلامة وقت الترجمة

Thread-Safe

آمن للاستخدام المتزامن في التطبيقات متعددة الخيوط

Builder Pattern

نمط منشئ بديهي لبناء الطلبات

Async Support

دعم CompletableFuture للعمليات غير المتزامنة

التكوين

متغيرات البيئة

قم بالتكوين باستخدام متغيرات البيئة أو خصائص النظام:
.env

التكوين اليدوي

قم بالتكوين يدويًا مع جميع الخيارات:

وضع الاختبار

قم بالتكوين لبيئة الاختبار/الصندوق الرمل:

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

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

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

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

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

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

قم بإنشاء وإدارة الاشتراكات المتكررة:
productPrice يتم التعبير عنه بأدنى فئة عملة (على سبيل المثال، السنت لـ USD، البايس لـ INR). لفرض رسوم بقيمة $25.00، مرر 2500.
يتم الشحن عبر subscriptions().charge(...) مصمم لـ الاشتراكات الفورية. ويتم دفع الاشتراكات المجدولة القياسية تلقائيًا بناءً على جدول تسعير المنتج.

الفوترة القائمة على الاستخدام

تكوين العدادات

قم بإنشاء وإدارة العدادات لتتبع الاستخدام:

استيعاب أحداث الاستخدام

تتبع الأحداث المخصصة:

تجميع الأحداث

استيعاب العديد من الأحداث بكفاءة (بحد أقصى 1000 لكل طلب):

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

معالجة أخطاء شاملة لمواقف مختلفة:
يقوم SDK بإعادة محاولة الطلبات تلقائيًا في حالة أخطاء الاتصال، و408، و409، و429، وأخطاء 5xx باستخدام تراجع أسي.

العمليات غير المتزامنة

استخدم CompletableFuture للعمليات غير المتزامنة:

تكامل Spring Boot

فئة التكوين

طبقة الخدمة

الموارد

GitHub Repository

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

API Reference

وثائق API كاملة

Discord Community

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

Report Issues

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

الدعم

تحتاج إلى مساعدة مع Java SDK؟

المساهمة

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