نموذج أسترو الأساسي

​

نظرة عامة

​

الميزات

• إعداد سريع - ابدأ في أقل من 5 دقائق
• دمج المدفوعات - تدفق دفع مُعد مسبقًا باستخدام @dodopayments/astro
• واجهة مستخدم حديثة - صفحة تسعير نظيفة ذات طابع داكن مع Tailwind CSS
• معالج ويب هوك - نقطة نهاية ويب هوك جاهزة للاستخدام لأحداث الدفع
• بوابة العملاء - إدارة الاشتراكات بنقرة واحدة
• TypeScript - مكتوب بالكامل مع أنواع مركزة ومحدودة
• دفع مسبق - يوضح تمرير بيانات العملاء لتحسين تجربة المستخدم

​

المتطلبات المسبقة

• إصدار Node.js LTS (مطلوب لأسترو 5)
• حساب مدفوعات دودي (للوصول إلى مفاتيح API وWebhook من لوحة التحكم)

​

بدء سريع

git clone https://github.com/dodopayments/dodo-astro-minimal-boilerplate.git
cd dodo-astro-minimal-boilerplate

npm install

cp .env.example .env

DODO_PAYMENTS_API_KEY=your_api_key_here
DODO_PAYMENTS_WEBHOOK_KEY=your_webhook_signing_key_here
DODO_PAYMENTS_RETURN_URL=http://localhost:4321/
DODO_PAYMENTS_ENVIRONMENT=test_mode

export const products: Product[] = [
  {
    product_id: "pdt_001", // Replace with your product ID
    name: "Basic Plan",
    description: "Get access to basic features and support",
    price: 9999, // in cents
    features: [
      "Access to basic features",
      "Email support",
      "1 Team member",
      "Basic analytics",
    ],
  },
  // ... add more products
];

npm run dev

​

هيكل المشروع

src/
├── components/
│   ├── Footer.astro           # Reusable footer
│   ├── Header.astro           # Navigation header
│   └── ProductCard.astro      # Product pricing card
├── layouts/
│   └── Layout.astro           # Root layout
├── lib/
│   └── products.ts            # Product definitions
├── pages/
│   ├── index.astro            # Pricing page (home)
│   └── api/
│       ├── checkout.ts        # Checkout session handler
│       ├── customer-portal.ts # Customer portal redirect
│       └── webhook.ts         # Webhook event handler
└── styles/
    └── global.css             # Global styles with Tailwind

​

التخصيص

​

تحديث معلومات المنتج

• معرفات المنتجات (من لوحة التحكم الخاصة بك في دودي)
• التسعير
• الميزات
• الأوصاف

​

ملء بيانات العملاء مسبقًا

customer: {
  name: "John Doe",
  email: "[email protected]",
},

​

تحديث بوابة العملاء

const CUSTOMER_ID = "cus_001"; // Replace with actual customer ID

​

أحداث الويب هوك

• onSubscriptionActive - يتم تفعيله عندما يصبح الاشتراك نشطًا
• onSubscriptionCancelled - يتم تفعيله عندما يتم إلغاء الاشتراك

onSubscriptionActive: async (payload) => {
  // Grant access to your product
  // Update user database
  // Send welcome email
},

​

النشر

​

تحديث عنوان URL للويب هوك

https://your-domain.com/api/webhook

​

استكشاف الأخطاء وإصلاحها

rm -rf node_modules package-lock.json
npm install

ngrok http 4321

​

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

• وثائق مدفوعات دودي
• وثائق جلسات الدفع
• وثائق الويب هوك

​

الدعم

• انضم إلى مجتمع Discord لطرح الأسئلة والمناقشات
• تحقق من مستودع GitHub للمشكلات والتحديثات
• اتصل بفريق الدعم لدينا للحصول على المساعدة