نظرة عامة على حزم SDK الرسمية

Dodo Payments توفر حزم SDK رسمية للعديد من لغات البرمجة، وقد صُممت كل منها وفق أفضل الممارسات الخاصة باللغة والميزات الحديثة لتوفير تكامل سلس مع المدفوعات.

استخدم دائمًا أحدث إصدار من SDK للوصول إلى أحدث الميزات والتحسينات. تحقق بانتظام من وجود تحديثات في مدير الحزم لديك لضمان الوصول إلى جميع إمكانات Dodo Payments.

حزم SDK المتاحة

اختر SDK المتوافق مع حزمة التقنيات لديك:

TypeScript SDK

تكامل يضمن سلامة الأنواع مع TypeScript وNode.js، باستخدام API قائم على الوعود والترقيم التلقائي للصفحات

Python SDK

واجهة بأسلوب Python مع دعم async/await للتطبيقات التي تستخدم Python 3.7 أو الإصدارات الأحدث

PHP SDK

SDK متوافق مع PSR-4 للتطبيقات الحديثة التي تستخدم PHP 8.1 أو الإصدارات الأحدث

Go SDK

واجهة Go بأسلوب اصطلاحي مع دعم السياق والكتابة الصارمة

Ruby SDK

واجهة Ruby أنيقة تتبع اصطلاحات Ruby وأفضل ممارساتها

Java SDK

SDK قوي وآمن في بيئات التنفيذ متعددة الخيوط لـ Java 8 والإصدارات الأحدث، مع دعم Maven وGradle

Kotlin SDK

SDK حديث لـ Kotlin مع coroutines وأمان القيم الفارغة ودوال الامتداد

C# SDK

SDK يضمن سلامة الأنواع لـ .NET 8 والإصدارات الأحدث، مع API قائم على async Task (إصدار تجريبي)

Rust SDK

SDK يعتمد على العمليات غير المتزامنة أولًا، ومبني على Tokio وreqwest، مع كتابة صارمة لـ Rust 1.75 والإصدارات الأحدث

CLI

واجهة سطر أوامر للتفاعل مع API من الطرفية

هل تبني تطبيقًا للهواتف المحمولة؟ راجع Mobile Checkout SDKs أدناه لـ Android وiOS وReact Native وFlutter.

البدء السريع

ابدأ باستخدام أي SDK خلال دقائق:

Install the SDK

استخدم مدير الحزم الخاص بلغتك لتثبيت SDK

TypeScript/Node.js
Python
PHP
Go
Rust

npm install dodopayments

pip install dodopayments

composer require dodopayments/client

go get github.com/dodopayments/dodopayments-go

cargo add dodopayments

Initialize the Client

اضبط إعدادات العميل باستخدام مفتاح API الخاص بك

TypeScript
Python
PHP
Go
Rust

import DodoPayments from 'dodopayments';
const client = new DodoPayments({ bearerToken: 'your_api_key' });

from dodopayments import DodoPayments
client = DodoPayments(bearer_token="your_api_key")

use Dodopayments\Client;
$client = new Client(bearerToken: 'your_api_key');

import "github.com/dodopayments/dodopayments-go"
client := dodopayments.NewClient(option.WithBearerToken("your_api_key"))

use dodopayments::Client;
let client = Client::from_env()?; // reads DODO_PAYMENTS_API_KEY

خزّن مفاتيح API دائمًا بأمان باستخدام متغيرات البيئة. لا تضعها أبدًا في نظام التحكم بالإصدارات.

Make Your First API Call

أنشئ جلسة Checkout أو عملية دفع

أصبحت الآن مستعدًا لمعالجة المدفوعات! انتقل إلى صفحات SDK الفردية للاطلاع على الأدلة والأمثلة التفصيلية.

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

تشترك جميع SDKs الخاصة بـ backend في هذه الإمكانات الأساسية. أما Mobile Checkout SDKs أدناه فهي أضيق نطاقًا عمدًا — لا تحتوي على مفتاح API ولا تستدعي API مطلقًا:

سلامة الأنواع: كتابة صارمة لضمان السلامة وقت الترجمة وتحسين دعم IDE
معالجة الأخطاء: معالجة شاملة للاستثناءات مع رسائل خطأ مفصلة
المصادقة: مصادقة بسيطة باستخدام مفتاح API مع دعم متغيرات البيئة
دعم العمليات غير المتزامنة: أنماط async/await الحديثة عند الاقتضاء
الترقيم التلقائي للصفحات: ترقيم تلقائي للصفحات في استجابات القوائم
الفوترة القائمة على الاستخدام: دعم مدمج لتتبع أحداث الاستخدام واستيعابها
الاختبار: دعم كامل لبيئة الاختبار للتطوير والاختبار

Mobile Checkout SDKs

إذا كنت تفضّل فتح hosted checkout page الخاصة بـ Dodo بدلًا من بناء واجهة دفع أصلية، فاستخدم Mobile Checkout SDK لمنصتك. تشترك SDKs الأربعة جميعًا في نفس العقد ذي الاستدعاء الواحد: يعيد start(...) قيمة CheckoutResult مكتوبة النوع، ولا يحتوي أيٌّ منها على مفتاح API، ويعمل Apple Pay/Google Pay بالطريقة نفسها التييعملان بها على الويب المفتوح، لأن checkout يُفتح في واجهة المتصفح الحقيقية للمنصة (SFSafariViewController / Custom Tabs)، وليس في WebView:

Android

Kotlin SDK يفتح Chrome Custom Tab. يتطلب minSdk 23

iOS

Swift SDK يفتح SFSafariViewController. يتطلب iOS 16+

React Native

Turbo Module يعمل فوق كلا النواتين الأصليتين. يتطلب React Native 0.76+

Flutter

قناة Pigeon تعمل فوق كلا النواتين الأصليتين. تتطلب Flutter 3.44+

Mobile Integration Guide

تدفق الدفع عبر الأجهزة المحمولة من البداية إلى النهاية، بدءًا من جلسة checkout في backend ووصولًا إلى إعداد مخطط callback

واجهة سطر الأوامر

لسير العمل والأتمتة المعتمدة على الطرفية:

CLI

واجهة سطر أوامر مُنشأة تلقائيًا مع دعم لـ Dodo Payments API

الميزات:

بنية أوامر قائمة على الموارد لاستخدام بديهي
تنسيقات إخراج متعددة (JSON وYAML ومنسّق وتفاعلي)
إكمال الأوامر في shell لـ bash وzsh وfish
مثالية للبرمجة النصية وأتمتة CI/CD

# Quick example
dodopayments payments list --format json | jq '.items[] | {payment_id, total_amount}'

Migration من Node.js SDK

لقد انتقلنا من Node.js SDK إلى TypeScript SDK الجديد. إذا كنت تستخدم Node.js SDK القديم، فراجع دليل Migration لتحديث تكاملك.

محولات Framework

يمكنك التكامل باستخدام أقل من 10 أسطر من التعليمات البرمجية عبر محولات framework الخاصة بنا. اختر من frameworks الموصى بها أو استكشف جميع الخيارات المدعومة.

Frameworks الموصى بها

Next.js

Framework متكامل يعتمد على React مع دعم App Router

Better Auth

Framework للمصادقة مع تكاملات مضمّنة

Supabase

بديل مفتوح المصدر لـ Firebase مع Postgres وAuth

Convex

Backend-as-a-Service مع إمكانات الوقت الفعلي

Show other 8+ supported frameworks

SvelteKit

Nuxt

Remix

Express

Fastify

Hono

Astro

TanStack

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

هل تحتاج إلى مساعدة بشأن أي SDK؟

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

المساهمة

نرحب بالمساهمات في جميع SDKs الخاصة بنا! يحتوي كل مستودع على ملف CONTRIBUTING.md يتضمن إرشادات بشأن:

الإبلاغ عن الأخطاء
طلب الميزات
إرسال pull requests
تشغيل الاختبارات محليًا
أسلوب التعليمات البرمجية والاصطلاحات

تفضل بزيارة صفحات SDK الفردية للوصول إلى مستودعات GitHub الخاصة بها وإرشادات المساهمة.

​حزم SDK المتاحة

TypeScript SDK

Python SDK

PHP SDK

Go SDK

Ruby SDK

Java SDK

Kotlin SDK

C# SDK

Rust SDK

CLI

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

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

​Mobile Checkout SDKs

Android

iOS

React Native

Flutter

Mobile Integration Guide

​واجهة سطر الأوامر

CLI

​Migration من Node.js SDK

​محولات Framework

​Frameworks الموصى بها

Next.js

Better Auth

Supabase

Convex

SvelteKit

Nuxt

Remix

Express

Fastify

Hono

Astro

TanStack

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

​المساهمة

حزم SDK المتاحة

البدء السريع

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

Mobile Checkout SDKs

واجهة سطر الأوامر

Migration من Node.js SDK

محولات Framework

Frameworks الموصى بها

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

المساهمة