واجهة سطر الأوامر الرسمية لـ Dodo Payments — إدارة الموارد، تشغيل الاستفسارات المدعومة بالذكاء الاصطناعي، إنشاء جلسات الدفع، واختبار webhooks من جهازك.
قم بإدارة موارد Dodo Payments، وتشغيل الاستفسارات المدعومة بالذكاء الاصطناعي على حسابك، وإنشاء جلسات الدفع، واختبار webhooks - كل ذلك من الطرفية. تأتي CLI مع واجهة مستخدم تفاعلية، ومساعد ذكاء اصطناعي مدمج مدعوم من MCP، واختبار webhook خارج الخط.
قبل استخدام الأوامر المصادق عليها، قم بتسجيل الدخول باستخدام مفتاح API الخاص بك:
dodo login
أو، من داخل واجهة المستخدم:
/login
تدفق تسجيل الدخول سيقوم بـ:
فتح متصفحك إلى صفحة مفاتيح API لـ Dodo Payments.
يُطلب منك لصق مفتاح API الخاص بك.
يطلب منك تحديد بيئة — وضع الاختبار أو الوضع المباشر.
تخزين الاعتمادات في مخزن سرية النظام (Keychain على macOS، وCredential Vault على Windows، وlibsecret على Linux).
لأن الاعتمادات مخزنة في مخزن سرية النظام، قد يُطلب منك تقديم كلمة مرور الجهاز الخاصة بك لأول مرة تقرأ فيها CLI أو تكتب الاعتمادات. إذا كنت تُرقّي من إصدار سابق، فسيتم نقل أي مفتاح API نصي موجود إلى مخزن السرية وحذف الملف القديم تلقائيًا.
استخدم اللغة الطبيعية لطرح الأسئلة أو اتخاذ الإجراءات. يستخدم المساعد 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 init يقوم ببناء مسارات الفواتير لـ Dodo Payments مباشرة في مشروع موجود. يقوم بإنشاء ملفات الطريق النموذجية، يثبت حزمة @dodopayments/* المتوافقة، ويكتب متغيرات البيئة DODO_PAYMENTS_* بأمان إلى .env الخاصة بك (فقط يضيف المتغيرات غير الموجودة بالفعل). يعمل الأمر بدون تسجيل الدخول.
dodo init <framework>
السقالة
الوصف
dodo init nextjs
بناء مسارات فوترة لـ Next.js App Router (عملية الشراء، بوابة العملاء، ومعالجات webhooks) باستخدام @dodopayments/nextjs
dodo init express
بناء مسارات فوترة خادم Express باستخدام @dodopayments/express
dodo init better-auth
بناء تكوين ملحق Better-Auth باستخدام @dodopayments/better-auth
بالنسبة للسقالة Better-Auth، يمكنك تمرير قائمة ملحقات مفصولة بفواصل لتوليدها (الافتراضي لجميعها): checkout، portal، usage، webhooks.
# Scaffold every Better-Auth plugin (default)dodo init better-auth# Scaffold only specific pluginsdodo init better-auth checkout,portal
السقالة تكتشف تلقائيًا دليل src/ وتضبط مسارات المخرجات وفقًا لذلك، وتكتشف تلقائيًا مدير الحزم الخاص بك (bun، pnpm، yarn، أو npm) لتشغيل أمر التثبيت الصحيح.
يتضمن CLI أداتين قويتين لاختبار webhooks أثناء التطوير: مستمع ينقل webhooks الاختبارية المباشرة إلى خادمك المحلي، و محفز يرسل تحميلات سعر وهمية إلى أي نقطة نهاية.
الأمر
الوصف
dodo wh listen
الاستماع للـ webhooks في الوقت الفعلي وتحويلها إلى خادم التطوير المحلي الخاص بك
dodo wh trigger
حفز حدث webhook اختباراً تفاعلياً — حتى أثناء تسجيل الخروج
حول 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) عند التحويل إلى نقطة النهاية المحلية الخاصة بك، حتى تتمكن من اختبار منطق التحقق من توقيعك.
إرسال حمولات webhooks وهمية إلى أي نقطة نهاية لاختبار سريع دون الحاجة إلى إنشاء معاملات حقيقية.
dodo wh trigger
يوجهك تدفق /wh trigger خلال:
إعداد عنوان URL لنقطة النهاية الإخراج
اختيار حدث معين لتحفيزه من قائمة تفاعلية
dodo wh trigger لا يتطلب تسجيل الدخول. إنه يعمل كمولد حمولات webhook محلي/غير متصل بالشبكة.
الأحداث المحفزة غير موقعة. أثناء الاختبار، قم بتعطيل التحقق من توقيع الـ webhook في نقطة النهاية الخاصة بك — على سبيل المثال، استخدم unsafe_unwrap() بدلاً من unwrap() في معالج الـ webhook أثناء الاختبار فقط.
