Skip to main content
يوفر SDK Go واجهة نظيفة وذات طابع لغوي لدمج مدفوعات دودو في تطبيقاتك. يقدم دعمًا للسياق، واستجابات ذات نوعية قوية، وقدرات على استخدام البرمجيات الوسيطة، وهو آمن للاستخدام المتزامن.

التثبيت

قم بتثبيت SDK باستخدام وحدات Go:
أو لتثبيت إصدار محدد:
يتطلب SDK Go 1.22 أو إصدارات أحدث، مستفيدًا من ميزات Go الحديثة للحصول على أداء مثالي.

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

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

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

Context Support

دعم كامل لـ context.Context للإلغاء وانتهاء المهلات

Strong Typing

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

Middleware

دعم قابل للتمديد لـ middleware لتسجيل الأحداث، والقياسات، والمنطق المخصص

Goroutine Safe

عميل آمن للخيوط مصمم للعمليات المتزامنة

التهيئة

السياق والمهل الزمنية

استفد من سياق Go للمهل الزمنية والإلغاء:

تهيئة إعادة المحاولة

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

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

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

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

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

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

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

قم بإنشاء وإدارة الاشتراكات المتكررة:
POST /subscriptions (طريقة subscriptions.create في SDK) مهملة. لا تزال تعمل مع عمليات التكامل الحالية، ولكن يجب أن تنشئ عمليات التكامل الجديدة الاشتراكات من خلال Checkout Session.
يتطلب Billing على الأقل رمز Country وفق معيار ISO مكوّنًا من حرفين. Customer هو CustomerRequestUnionParam — مرّر AttachExistingCustomerParam{CustomerID: ...} لعميل حالي أو NewCustomerParam{Email: ..., Name: ...} لعميل جديد. تكون قيمة ProductPrice بأدنى فئة من فئات العملة.

الفوترة حسب الاستخدام

إدخال أحداث الاستخدام

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

سرد أحداث الاستخدام

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

عندما تُرجع API رمز حالة غير ناجح، يُرجع SDK خطأً من النوع *dodopayments.Error. ويكشف عن StatusCode و*http.Request الأساسي و *http.Response، بالإضافة إلى JSON لنص الخطأ. استخدم نمط errors.As لفحصه، وتفرّع استنادًا إلى StatusCode للتعامل مع حالات محددة:

Middleware

أضف Middleware مخصّصًا للتسجيل أو المقاييس:

التزامن

العميل آمن للاستخدام المتزامن:

الموارد

GitHub Repository

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

API Reference

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

Discord Community

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

Report Issues

أبلغ عن الأخطاء أو اطلب ميزات جديدة

الدعم

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

المساهمة

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