نظرة عامة على موصلات الإطار

تقدم مدفوعات دودي موصلات رسمية للإطار تسهل دمج المدفوعات. تم تصميم كل موصل للعمل بسلاسة مع تقاليد إطارك، مما يوفر معالجة الدفع، وبوابة العملاء، والتعامل مع الويب هوك بشكل مباشر.

تتيح لك الموصلات الخاصة بالأطر دمج 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 مع حمولات بيانات مطبوعة

البدء السريع

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

Install the Adaptor

استخدم مدير الحزم الخاص بك لتثبيت الموصل الخاص بالإطار:

npm install @dodopayments/nextjs

npm install @dodopayments/nuxt

npm install @dodopayments/express

npm install @dodopayments/hono

npm install @dodopayments/astro

npm install @dodopayments/sveltekit

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 أو الأسرار في نظام التحكم في الإصدارات أبدًا.

Create Route Handlers

أعد إعداد مسارات Checkout والبوابة والويب هوكس الخاصة بك:

Next.js
Express
Hono

// 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,
});

import { checkoutHandler } from '@dodopayments/express';

app.get('/api/checkout', checkoutHandler({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
  environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
}));

import { Checkout } from "@dodopayments/hono";

app.get('/checkout', Checkout({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
  environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
}));

أنت الآن جاهز لمعالجة المدفوعات! قم بزيارة صفحات الموصل الفردية لمعرفة الأدلة التفصيلية وجميع الخيارات المتاحة.

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

جميع الموصلات تدعم ثلاثة أنواع من تدفق الدفع:

Static Checkout (GET)

استخدم الدفع الثابت للروابط البسيطة والمشاركة. مرر معرف المنتج كمعامل استعلام:

/api/checkout?productId=pdt_xxx&quantity=1

يدعم ملء بيانات العميل المسبق والتخصيص اختياريًا عبر معاملات الاستعلام.

Dynamic Checkout (POST)

استخدم الدفع الديناميكي لإنشاء المدفوعات برمجيًا بتفاصيل مخصصة:

{
  "product_id": "pdt_xxx",
  "customer": {
    "email": "customer@example.com",
    "name": "John Doe"
  },
  "quantity": 1
}

يدعم كل من المدفوعات مرة واحدة والاشتراكات.

Checkout Sessions (POST)

استخدم جلسات الدفع لأكثر تجارب الدفع مرونة مع دعم السلة:

{
  "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 Router	Node.js، Edge
Nuxt	تطبيقات Vue.js الكاملة	Node.js
Express	واجهات برمجة التطبيقات REST والتطبيقات التقليدية	Node.js
Fastify	واجهات برمجة تطبيقات عالية الأداء	Node.js
Hono	عمليات النشر على الحافة و Cloudflare Workers	Edge، Node.js
Astro	مواقع محتوى مع نقاط نهاية الخادم	Node.js، Edge
SvelteKit	تطبيقات Svelte الكاملة	Node.js
Remix	React كامل مع التوجيه المتداخل	Node.js
TanStack Start	React الكامل الآمن بالأنواع	Node.js
Better Auth	التطبيقات التي تستخدم Better Auth بالفعل	متنوع
Convex	التطبيقات التي تستخدم Convex للبنية الخلفية	Convex Runtime
Bun	تطبيقات خادم Bun الأصلية	Bun

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

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

Discord: انضم إلى خادم المجتمع للحصول على مساعدة فورية
البريد الإلكتروني: تواصل معنا عبر support@dodopayments.com
GitHub: افتح مشكلة في مستودع الموصل المعني
التوثيق: تصفح مرجع واجهة برمجة التطبيقات
Discord: انضم إلى خادم المجتمع للحصول على مساعدة في الوقت الحقيقي
البريد الإلكتروني: اتصل بنا على support@dodopayments.com
GitHub: افتح مشكلة في مستودع الموصل المعني
التوثيق: قم بزيارة مرجع API
Discord: Join our community server for real-time help
Email: Contact us at support@dodopayments.com
GitHub: Open an issue on the respective adaptor repository
Documentation: Visit our API reference

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

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

Bun

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

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

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

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

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

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

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

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

البدء السريع

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

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

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

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