SDK الفوترة

​

نظرة عامة

• مكونات React: مكونات فوترة مسبقة البناء وقابلة للتخصيص لتطبيقات React
• أدوات CLI: واجهة سطر الأوامر لتهيئة المشروع وإدارة المكونات
• دعم الأطر: التكامل مع Next.js، Express.js، Hono، Fastify، وReact
• موفر الدفع: تكامل كامل مع مدفوعات دودي

​

بدء سريع

npx @billingsdk/cli --help

npm install -g @billingsdk/cli

npx @billingsdk/cli init

npx @billingsdk/cli add pricing-table-one
npx @billingsdk/cli add subscription-management

​

الأطر المدعومة

​

أوامر CLI

​

@billingsdk/cli init

1. اختيار الإطار: اختر إطار العمل المفضل لديك
2. تثبيت القالب: يقوم بتنزيل وتثبيت قوالب محددة للإطار مع تكامل مدفوعات دودي
3. إدارة الاعتماديات: يقوم تلقائيًا بتثبيت الاعتماديات المطلوبة
4. إنشاء الملفات: ينشئ ملفات التكوين الضرورية وكود البداية

npx @billingsdk/cli init

​

@billingsdk/cli add

# Add a pricing table
npx @billingsdk/cli add pricing-table-one

# Add subscription management
npx @billingsdk/cli add subscription-management

# Add usage monitoring
npx @billingsdk/cli add usage-meter-circle

1. يقوم بتنزيل تكوين المكون من السجل
2. يقوم بتثبيت ملفات المكون في دليل components/billingsdk/ الخاص بك
3. يقوم بتحديث تكوين مشروعك إذا لزم الأمر
4. يقوم بتثبيت أي اعتماديات إضافية

​

هيكل الملفات الناتجة

• مسارات API: نقاط نهاية شاملة للدفع، العملاء، المنتجات، الاشتراكات، وwebhooks
• خطافات: خطافات React لعمليات الفوترة (إذا كنت تستخدم React/Next.js)
• ملفات المكتبة: تهيئة عميل موفر الدفع والأدوات المساعدة
• تكوين البيئة: ملفات متغيرة البيئة كمثال

​

هيكل مثال Next.js

your-project/
├── app/api/
│   └── (dodopayments)/
│       ├── checkout/route.ts
│       ├── customer/route.ts
│       ├── customer/payments/route.ts
│       ├── customer/subscriptions/route.ts
│       ├── product/route.ts
│       ├── products/route.ts
│       └── webhook/route.ts
├── hooks/
│   └── useBilling.ts
├── lib/
│   └── dodopayments.ts
└── .env.example

​

تكوين البيئة

# DodoPayments
DODO_PAYMENTS_API_KEY=your_api_key_here
DODO_PAYMENTS_ENVIRONMENT=test_mode
DODO_PAYMENTS_WEBHOOK_KEY=your_webhook_key_here

# App URL
NEXT_PUBLIC_APP_URL=http://localhost:3000

​

المكونات المتاحة

• جداول الأسعار: عدة متغيرات لعرض أسعار المنتجات
• إدارة الاشتراكات: مكونات لإدارة اشتراكات العملاء
• مراقبة الاستخدام: مكونات بصرية لتتبع الفوترة المعتمدة على الاستخدام
• مكونات الدفع: تدفقات دفع مسبقة البناء
• بوابة العملاء: مكونات لخدمة العملاء الذاتية

​

مفتوح المصدر

• 🔍 الشفافية: رؤية كاملة لكيفية عمل المكونات
• 🤝 المجتمع: مبني من قبل المطورين، للمطورين
• 🔒 الأمان: الكود المفتوح يعني أمانًا أفضل من خلال مراجعة الأقران
• 📈 الابتكار: تكرار أسرع من خلال مساهمات المجتمع

​

الحصول على المساعدة

• مشاكل GitHub: افتح مشكلة
• التوثيق: زيارة billingsdk.com/docs
• التوثيق الكامل لـ LLMs: billingsdk.com/llms-full.txt

​

المساهمة

• الإبلاغ عن الأخطاء
• طلب الميزات
• تقديم طلبات السحب
• إضافة مكونات جديدة
• تحسين التوثيق

​

تعرف على المزيد