الانتقال إلى المحتوى الرئيسي
قم بإدارة موارد Dodo Payments، وتشغيل الاستفسارات المدعومة بالذكاء الاصطناعي على حسابك، وإنشاء جلسات الدفع، واختبار webhooks - كل ذلك من الطرفية. تأتي CLI مع واجهة مستخدم تفاعلية، ومساعد ذكاء اصطناعي مدمج مدعوم من MCP، واختبار webhook خارج الخط.

الميزات

  • واجهة مستخدم تفاعلية — قم بتشغيل dodo دون وجود أي وسيطات لفتح الواجهة التفاعلية بالكامل مع لوحة الأوامر، والتاريخ، والإشعارات الحية.
  • المساعد الذكي المدمج — اطرح الأسئلة أو قم بالإجراءات باللغة الإنجليزية العادية مع /ai. لا تتطلب إعدادًا إضافيًا، يعمل dodopayments-mcp محلياً.
  • آمن افتراضيًا — يتم تخزين مفاتيح API في مخزن سرية النظام (macOS Keychain، Windows Credential Vault، Linux libsecret). لا يوجد إعداد نص عادي على القرص.
  • تحديث تلقائي — تقوم CLI بالتحقق من الإصدارات الجديدة عند بدء التشغيل وتبلغك داخل التطبيق. قم بتشغيل /update للترقية في المكان.
  • أدوات Webhook — استمع إلى webhooks الحية أو قم بتشغيل الحمولة خارج الخط للتطوير المحلي.

التثبيت

قم بتثبيت CLI في سطر واحد على macOS أو Linux:
curl -fsSL https://dodopayments.com/install.sh | sh

التثبيت باستخدام npm أو Bun

إذا كان لديك بالفعل Node أو Bun، فالتثبيتات باستخدام مدير الحزم تسحب دائمًا الإصدار الأحدث:
npm install -g dodopayments-cli

التثبيت اليدوي (لا يلزم Node / Bun)

إذا كنت تفضل عدم توجيه سكريبت عن بعد إلى sh، قم بتحميل الملف الثنائي بنفسك.
1

Download the binary

قم بتحميل الملف الثنائي لمنصتك من GitHub Release الأحدث.
المنصةالملف الثنائي
macOS (Apple Silicon)dodo-cli-darwin-arm64
macOS (Intel)dodo-cli-darwin-x64
Linux (x86_64)dodo-cli-linux-x64
Linux (arm64)dodo-cli-linux-arm64
Windows (x86_64)dodo-cli-windows-x64.exe
2

Rename the binary to `dodo`

mv ./dodo-cli-* ./dodo && chmod +x ./dodo
3

Move it to a directory on your PATH

sudo mv ./dodo /usr/local/bin/
على Windows، يتطلب النقل إلى C:\Windows\System32 صلاحيات المسؤول.
4

(Optional) Verify the download

كل إصدار ينشر SHA256SUMS.txt. تحقق من تحميلك بواسطة:
shasum -a 256 -c SHA256SUMS.txt

المصادقة

قبل استخدام الأوامر المصادق عليها، قم بتسجيل الدخول باستخدام مفتاح API الخاص بك:
dodo login
أو، من داخل واجهة المستخدم:
/login
تدفق تسجيل الدخول سيقوم بـ:
  1. فتح متصفحك إلى صفحة مفاتيح API لـ Dodo Payments.
  2. يُطلب منك لصق مفتاح API الخاص بك.
  3. يطلب منك تحديد بيئة — وضع الاختبار أو الوضع المباشر.
  4. تخزين الاعتمادات في مخزن سرية النظام (Keychain على macOS، وCredential Vault على Windows، وlibsecret على Linux).
لأن الاعتمادات مخزنة في مخزن سرية النظام، قد يُطلب منك تقديم كلمة مرور الجهاز الخاصة بك لأول مرة تقرأ فيها CLI أو تكتب الاعتمادات. إذا كنت تُرقّي من إصدار سابق، فسيتم نقل أي مفتاح API نصي موجود إلى مخزن السرية وحذف الملف القديم تلقائيًا.

التبديل بين الأوضاع وتسجيل الخروج

يمكنك الاحتفاظ بمفتاح واحد مصادق عليه لـ وضع الاختبار والوضع المباشر في نفس الوقت. لمسح الاعتمادات:
dodo logout
يسمح لك تدفق تسجيل الخروج بالاختيار بين جميع الحسابات، وضع الاختبار، أو الوضع المباشر بشكل مستقل.

الاستخدام

يمكنك استخدام CLI في وضعين.

1. واجهة المستخدم التفاعلية (موصى بها)

قم بتشغيل dodo دون وجود أي وسيطات لبدء الواجهة التفاعلية الكاملة:
dodo
اكتب / لفتح لوحة الأوامر، أو ابدأ بالكتابة مباشرة — يتم إرسال أي شيء ليس أمرًا بشريون إلى المساعد الذكي.
الأمرالوصف
/helpعرض مرجع الأوامر
/updateالتحقق من وجود تحديث لـ CLI وتثبيته
/loginالمصادقة بمفتاح API
/logoutتسجيل الخروج من بيئة واحدة أو جميعها
/clearمسح شاشة TUI
/exitالخروج من TUI (أيضًا: اكتب exit، أو اضغط على Esc مرتين)

2. الأوامر الفرعية المباشرة

قم بتشغيل الأوامر مباشرة دون الدخول إلى TUI:
dodo <category> <sub-command> [args...]
على سبيل المثال:
dodo payments list 1
dodo customers create
dodo wh trigger
تظهر جداول المراجع أدناه كل أمر. في TUI، قم بتقديمها بـ /؛ في الوضع المباشر، أسقط /.

المساعد الذكاء الاصطناعي

استخدم اللغة الطبيعية لطرح الأسئلة أو اتخاذ الإجراءات. يستخدم المساعد dodopayments-mcp بشكل محلي — لا يتطلب إعدادًا إضافيًا أو تدفق OAuth، ولا يترك مرور الذكاء الاصطناعي جهازك إلا للتحدث مع موفر النموذج.
الأمرالوصف
/ai <query>اسأل المساعد الذكي سؤالًا أو قدم له تعليمًا
(أي نص ليس أمرًا بشريون)يتم إرساله إلى المساعد الذكي بشكل افتراضي أثناء تواجدك في TUI
أمثلة:
how much revenue did I make this week?
/ai create a new customer named Acme Inc.
/ai find my last failed payment
يحترم المساعد البيئة النشطة الخاصة بك (الاختبار / المباشر)، لذا فهو يعمل فقط على البيانات من البيئة التي سجلت فيها الدخول حاليًا.

مرجع الأوامر

المنتجات

قم بإدارة كتالوج منتجاتك.
الأمرالوصف
dodo products list <page>قائمة المنتجات
dodo products createافتح لوحة التحكم لإنشاء منتج
dodo products info <id>عرض التفاصيل لمنتج محدد

المدفوعات

عرض معاملات الدفع.
الأمرالوصف
dodo payments list <page>قائمة المدفوعات
dodo payments info <id>الحصول على معلومات حول دفعة معينة

العملاء

إدارة قاعدة عملائك.
الأمرالوصف
dodo customers list <page>قائمة العملاء
dodo customers createإنشاء عميل جديد
dodo customers update <id>تحديث عميل موجود

الخصومات

إدارة القسائم والخصومات.
الأمرالوصف
dodo discounts list <page>قائمة الخصومات
dodo discounts createإنشاء خصم جديد مستند إلى النسبة المئوية
dodo discounts delete <id>إزالة خصم بواسطة ID

التراخيص

إدارة تراخيص البرمجيات.
الأمرالوصف
dodo licences list <page>قائمة التراخيص

الإضافات

إدارة إضافات المنتج.
الأمرالوصف
dodo addons list <page>قائمة الإضافات
dodo addons createافتح لوحة التحكم لإنشاء إضافة
dodo addons info <id>عرض التفاصيل لإضافة محددة

الاستردادات

عرض معلومات الاسترداد.
الأمرالوصف
dodo refunds list <page>قائمة الاستردادات
dodo refunds info <id>عرض التفاصيل لاسترداد محدد

الدفع

إنشاء جلسات الدفع المستضافة.
الأمرالوصف
dodo checkout newإنشاء جلسة دفع تفاعلية واحصل على رابط دفع

Webhooks

تتضمن CLI أداتين قويتين لاختبار webhooks أثناء التطوير: مستمع يقوم بإعادة توجيه webhooks الاختبارية الحية إلى خادمك المحلي، ومشغل يرسل حمولات webhook تجريبية إلى أي نقطة نهاية.
الأمرالوصف
dodo wh listenاستمع إلى webhooks في الوقت الفعلي وأعد توجيهها إلى خادم التطوير المحلي الخاص بك
dodo wh triggerقم بتشغيل حدث اختبار webhook بشكل تفاعلي — حتى أثناء تسجيل الخروج

الاستماع إلى webhooks

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

Enter your local endpoint URL

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

Automatic setup

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

Receive and forward

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

تشغيل اختبارات webhook

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

الأحداث المدعومة لـ webhook

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

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

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

التحديثات

تقوم CLI بالتحقق من وجود إصدار أحدث عند بدء التشغيل وتعرض إشعارًا في شريط الحالة عند توفره. للترقية:
/update
أو، أعد تشغيل المثبت للترقية في المكان:
curl -fsSL https://dodopayments.com/install.sh | sh

الموارد

GitHub Repository

عرض كود المصدر والإصدارات

npm Package

عرض في سجل npm

الدعم

Last modified on May 22, 2026