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

​
التثبيت

npm install -g dodopayments-cli

​
التثبيت اليدوي

  1. قم بتنزيل الإصدار الأحدث من GitHub Releases لنظامك
  2. فكّ الضغط وأعد تسمية الملف التنفيذي إلى dodo
  3. انقل إلى دليل في متغير PATH الخاص بك:
sudo mv ./dodo /usr/local/bin/

​
المصادقة

قبل استخدام واجهة سطر الأوامر، قم بالمصادقة باستخدام مفتاح واجهة برمجة التطبيقات الخاص بك: 
dodo login
سيقوم ما يلي:
  1. فتح متصفحك على صفحة مفاتيح واجهة برمجة التطبيقات في Dodo Payments
  2. مطالبتك بإدخال مفتاح واجهة برمجة التطبيقات
  3. طلب اختيار البيئة (وضع الاختبار أو الوضع الفعلي)
  4. تخزين بيانات اعتمادك محليًا في ~/.dodopayments/api-key
يدعم CLI تخزين مفتاح واجهة برمجة تطبيقات واحد لكل بيئة. إذا تم تكوين مفاتيح وضع الاختبار والوضع الفعلي معًا، فسيُطلب منك اختيار البيئة التي تريد استخدامها للجلسة الحالية.

​
الاستخدام

الصيغة العامة هي: 
dodo ‹category› ‹sub-command›
تشغيل dodo بدون وسيطات يعرض جميع الفئات المتاحة. تشغيل dodo <category> بدون أمر فرعي يعرض الأوامر الفرعية المتاحة لتلك الفئة.

​
المنتجات

قم بإدارة كتالوج المنتجات الخاص بك.
الأمرالوصف
dodo products listعرض جميع المنتجات (مقسمة إلى صفحات)
dodo products createافتح لوحة التحكم لإنشاء منتج
dodo products infoعرض تفاصيل منتج محدد

​
المدفوعات

عرض معاملات الدفع.
الأمرالوصف
dodo payments listعرض جميع الدفعات (مقسمة إلى صفحات)
dodo payments infoالحصول على معلومات حول دفعة معينة

​
العملاء

قم بإدارة قاعدة عملائك.
الأمرالوصف
dodo customers listعرض جميع العملاء (مقسمة إلى صفحات)
dodo customers createإنشاء ملف تعريف عميل جديد
dodo customers updateتحديث تفاصيل عميل موجود

​
الخصومات

إدارة القسائم والخصومات.
الأمرالوصف
dodo discounts listعرض جميع الخصومات (مقسمة إلى صفحات)
dodo discounts createإنشاء خصم جديد بنسب مئوية
dodo discounts deleteإزالة خصم حسب المعرف

​
الرخص

إدارة تراخيص البرامج.
الأمرالوصف
dodo licences listعرض جميع مفاتيح الترخيص (مقسمة إلى صفحات)

​
الإضافات

إدارة الإضافات الخاصة بالمنتجات.
الأمرالوصف
dodo addons listعرض جميع الإضافات (مقسمة إلى صفحات)
dodo addons createافتح لوحة التحكم لإنشاء إضافة
dodo addons infoعرض تفاصيل إضافة معينة

​
عمليات الاسترداد

عرض معلومات الاسترداد.
الأمرالوصف
dodo refund listعرض جميع الاستردادات (مقسمة إلى صفحات)
dodo refund infoعرض تفاصيل استرداد معين

​
صفحة الدفع

إنشاء جلسات الدفع.
الأمرالوصف
dodo checkout newإنشاء جلسة دفع جديدة والحصول على رابط الدفع
يدعم أمر الدفع خيارات متقدمة تشمل جمع أقل قدر من العناوين، عنوان URL للعودة، فرض 3D Secure، رموز الخصم، والبيانات الوصفية.

​
اختبار الويب هوك

تتضمن واجهة سطر الأوامر أداتين قويتين لاختبار الويب هوك أثناء التطوير: المستمع الذي يعيد توجيه الويب هوك الخاصة بالاختبار المباشر إلى خادمك المحلي، والمشغّل الذي يرسل بيانات وهمية لأي نقطة نهاية.

​
الاستماع إلى الويب هوك

إعادة توجيه الويب هوك من Dodo Payments مباشرة إلى خادم التطوير المحلي في الوقت الفعلي. 
dodo wh listen
1

Enter your local endpoint URL

قدّم عنوان URL المحلي الذي ترغب في استلام الويب هوك عليه (على سبيل المثال، http://localhost:3000/webhook).
2

Automatic setup

يقوم CLI بإنشاء نقطة نهاية للويب هوك على حساب Dodo Payments تلقائيًا إذا لم تكن موجودة بالفعل، ثم يفتح اتصال WebSocket لتلقي الأحداث في الوقت الفعلي.
3

Receive and forward

عند حدوث حدث ويب هوك (من دفعة اختبار، تغيير اشتراك، إلخ)، يتلقاه CLI، ويسجل نوع الحدث، ويعيد توجيه الطلب الكامل مع رؤوسه ومحتواه إلى نقطة النهاية المحلية الخاصة بك. يتم تسجيل الاستجابة من نقطة النهاية الخاصة بك وإرسالها مرة أخرى.
يعمل مستمع الويب هوك فقط مع مفتاح واجهة برمجة تطبيقات لوضع الاختبار. تأكد من تسجيل الدخول باستخدام مفتاح وضع الاختبار قبل استخدام dodo wh listen.
يحتفظ المستمع بالرؤوس الأصلية للويب هوك (webhook-id, webhook-signature, webhook-timestamp) عند إعادة التوجيه إلى نقطة النهاية المحلية الخاصة بك، حتى تتمكن من اختبار منطق التحقق من التوقيع.

​
تشغيل ويب هوك اختبارية

أرسل حمولة ويب هوك وهمية إلى أي نقطة نهاية لإجراء اختبار سريع دون الحاجة إلى إنشاء معاملات حقيقية. 
dodo wh trigger
هذا الدليل يأخذك عبر:
  1. تحديد عنوان نقطة النهاية الوجهة
  2. اختيارياً تكوين معرف العمل، معرف المنتج، والبيانات الوصفية
  3. اختيار حدث محدد لتفعيله من قائمة تفاعلية
  4. إرسال الحمولة الوهمية وعرض الاستجابة
بعد كل حدث، يمكنك اختيار حدث آخر لتفعيله أو الخروج — مما يجعل من السهل اختبار عدة معالجات أحداث في جلسة واحدة.
ترسل أداة المشغّل حمولات وهمية بدون توقيعات ويب هوك. قم بإيقاف تشغيل التحقق من توقيعات الويب هوك أثناء الاختبار باستخدام unsafe_unwrap() بدلًا من unwrap() في معالج الويب هوك الخاص بك.

​
أحداث الويب هوك المدعومة

الفئةالأحداث
الاشتراكsubscription.active, subscription.updated, subscription.on_hold, subscription.renewed, subscription.plan_changed, subscription.cancelled, subscription.failed, subscription.expired
الدفعةpayment.success, payment.failed, payment.processing, payment.cancelled
الاستردادrefund.success, refund.failed
النزاعdispute.opened, dispute.expired, dispute.accepted, dispute.cancelled, dispute.challenged, dispute.won, dispute.lost
الرخصةlicence.created

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

المتغيرالوصف
DODO_WH_TEST_SERVER_URLاستبدال عنوان URL الافتراضي لخادم تمرير الويب هوك المستخدم بواسطة dodo wh listen

​
الموارد

GitHub Repository

عرض شفرة المصدر والإصدارات

npm Package

عرض على سجل npm

​
الدعم