Skip to main content
يوفر 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

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

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

وضع الاختبار

قم بالإعداد لبيئة Test Mode:

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

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

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

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

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

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

قم بإنشاء وإدارة الاشتراكات المتكررة:
POST /subscriptions (طريقة subscriptions.create في SDK) مهملة. لا تزال تعمل مع عمليات التكامل الحالية، ولكن ينبغي لعمليات التكامل الجديدة إنشاء الاشتراكات من خلال Checkout Session.
يتم التعبير عن 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؟

المساهمة

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