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

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

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

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

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

Next.js

دعم موجه التطبيق مع معالجات المسار للدفع، والبوابة، والويب هوك

Nuxt

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

Express

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

Fastify

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

Hono

إطار عمل ويب فائق السرعة للحافة، وعمال Cloudflare، وأكثر

Astro

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

SvelteKit

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

Remix

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

TanStack Start

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

Better Auth

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

Convex

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

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

توفر جميع موصلات الإطار هذه القدرات المدمجة:

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

البدء السريع

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

تثبيت الموصل

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

npm install @dodopayments/nextjs

npm install @dodopayments/nuxt

npm install @dodopayments/express

npm install @dodopayments/hono

npm install @dodopayments/astro

npm install @dodopayments/sveltekit

تكوين متغيرات البيئة

أضف بيانات اعتماد مدفوعات دودي إلى بيئتك:

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

إنشاء معالجات المسار

قم بإعداد مسارات الدفع، وبوابة العملاء، والويب هوك:

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

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

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

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

الدفع الثابت (GET)

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

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

يدعم تعبئة العملاء الاختيارية والتخصيص عبر معاملات الاستعلام.

الدفع الديناميكي (POST)

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

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

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

جلسات الدفع (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 كاملة مع موجه التطبيق	Node.js، Edge
Nuxt	تطبيقات Vue.js كاملة	Node.js
Express	واجهات برمجة التطبيقات REST وتطبيقات Node.js التقليدية	Node.js
Fastify	واجهات برمجة التطبيقات عالية الأداء	Node.js
Hono	نشرات الحافة، عمال Cloudflare	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

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

هل تحتاج إلى مساعدة بشأن موصلات الإطار؟

Discord: انضم إلى خادم المجتمع للحصول على مساعدة في الوقت الحقيقي
البريد الإلكتروني: اتصل بنا على support@dodopayments.com
GitHub: افتح مشكلة في مستودع الموصل المعني
التوثيق: قم بزيارة مرجع API

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

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

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

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

البدء السريع

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

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

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

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

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

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

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

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

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

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

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

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

البدء السريع

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

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

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

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