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

​
موصلات الإطار المتاحة

اختر الموصل الذي يتناسب مع إطارك:

Next.js

دعم App Router مع معالجات المسارات للدفع والبوابة والويب هوكس

Nuxt

إطار عمل متكامل مبني على Vue مع تكامل لمسارات الخادم

Express

معالجات قائمة على الوسيط لإطار Node.js الشهير

Fastify

إطار Node.js عالي الأداء مع بنية مكوّنات إضافية

Hono

إطار ويب فائق السرعة للحافة و Cloudflare Workers والمزيد

Astro

إطار يركز على المحتوى مع دعم نقاط نهاية الخادم

SvelteKit

إطار Svelte متكامل كامل مع تكامل روابط الخادم

Remix

إطار React متكامل كامل مع معالجات المحمّل والإجراءات

TanStack Start

إطار React متكامل آمن بالأنواع مع وظائف الخادم

Better Auth

إضافة إطار عمل المصادقة لتجربة سلسة للمصادقة والدفع

Convex

مكوّن Backend-as-a-Service لمزامنة الدفع في الوقت الفعلي

Bun

معالجات Bun.serve() الأصلية للدفع والبوابة والويب هوكس

​
الميزات الأساسية

توفر جميع موصلات الأطر هذه القدرات المدمجة:
الميزةالوصف
معالج الدفعدعم لتدفقات الدفع الثابتة والديناميكية والتي تستند إلى الجلسات
بوابة العملاءمعالج مبني مسبقًا لإدارة الاشتراكات والفوترة
معالج الويب هوكسالتحقق من التوقيع الآمن مع معالجات أحداث مطبوعة
إعداد البيئةإعداد بسيط عبر متغيرات البيئة
أمان الأنواعدعم كامل لـ TypeScript مع حمولات بيانات مطبوعة

​
البدء السريع

ابدأ بأي موصل إطار في ثلاث خطوات:
1

Install the Adaptor

استخدم مدير الحزم الخاص بك لتثبيت الموصل الخاص بالإطار:
npm install @dodopayments/nextjs
2

Configure Environment Variables

أضف بيانات اعتماد Dodo Payments إلى بيئتك:
DODO_PAYMENTS_API_KEY=your-api-key
DODO_PAYMENTS_WEBHOOK_KEY=your-webhook-secret
DODO_PAYMENTS_RETURN_URL=https://yourdomain.com/checkout/success
DODO_PAYMENTS_ENVIRONMENT="test_mode" # or "live_mode"
لا تُدرِج ملف .env أو الأسرار في نظام التحكم في الإصدارات أبدًا.
3

Create Route Handlers

أعد إعداد مسارات Checkout والبوابة والويب هوكس الخاصة بك:
// app/checkout/route.ts
import { Checkout } from "@dodopayments/nextjs";

export const GET = Checkout({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
  environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
});
أنت الآن جاهز لمعالجة المدفوعات! قم بزيارة صفحات الموصل الفردية لمعرفة الأدلة التفصيلية وجميع الخيارات المتاحة.

​
أنواع تدفقات الدفع

جميع الموصلات تدعم ثلاثة أنواع من تدفق الدفع:
استخدم الدفع الثابت للروابط البسيطة والمشاركة. مرر معرف المنتج كمعامل استعلام:
/api/checkout?productId=pdt_xxx&quantity=1
يدعم ملء بيانات العميل المسبق والتخصيص اختياريًا عبر معاملات الاستعلام.
استخدم الدفع الديناميكي لإنشاء المدفوعات برمجيًا بتفاصيل مخصصة:
{
  "product_id": "pdt_xxx",
  "customer": {
    "email": "customer@example.com",
    "name": "John Doe"
  },
  "quantity": 1
}
يدعم كل من المدفوعات مرة واحدة والاشتراكات.
استخدم جلسات الدفع لأكثر تجارب الدفع مرونة مع دعم السلة:
{
  "product_cart": [
    { "product_id": "pdt_xxx", "quantity": 1 },
    { "product_id": "pdt_yyy", "quantity": 2 }
  ],
  "customer": {
    "email": "customer@example.com"
  }
}
تعرف على المزيد في دليل جلسات الدفع.

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

جميع الموصلات توفر معالجة ويب هوكس آمنة بأنواع مع ردود نداء للأحداث التفصيلية: 
Webhooks({
  webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_KEY,
  onPayload: async (payload) => {
    // Handle any webhook event
  },
  onPaymentSucceeded: async (payload) => {
    // Handle successful payments
  },
  onSubscriptionActive: async (payload) => {
    // Handle new subscriptions
  },
  // ... 20+ event types supported
});
جميع معالجات الويب هوكس تتحقق تلقائيًا من التوقيعات وتتحقق من صحة الحمولات باستخدام مخططات Zod. يتم رفض الطلبات غير الصالحة مع رموز خطأ مناسبة.

​
اختيار الموصل المناسب

الإطارالأفضل من أجلهوقت التشغيل
Next.jsتطبيقات React الكاملة مع App RouterNode.js، Edge
Nuxtتطبيقات Vue.js الكاملةNode.js
Expressواجهات برمجة التطبيقات REST والتطبيقات التقليديةNode.js
Fastifyواجهات برمجة تطبيقات عالية الأداءNode.js
Honoعمليات النشر على الحافة و Cloudflare WorkersEdge، Node.js
Astroمواقع محتوى مع نقاط نهاية الخادمNode.js، Edge
SvelteKitتطبيقات Svelte الكاملةNode.js
RemixReact كامل مع التوجيه المتداخلNode.js
TanStack StartReact الكامل الآمن بالأنواعNode.js
Better Authالتطبيقات التي تستخدم Better Auth بالفعلمتنوع
Convexالتطبيقات التي تستخدم Convex للبنية الخلفيةConvex Runtime
Bunتطبيقات خادم Bun الأصليةBun

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

هل تحتاج لمساعدة في موصلات الأطر؟