اطلب الوصول المبكر

أدخل اسمك الأول وبريدك الإلكتروني أو رقم هاتفك. سنتواصل معك لتزويدك بتفاصيل الوصول إلى Tajo.

في هذه الصفحة

دليل التكامل مع تطبيقات Stripe

تتيح لك تطبيقات Stripe تضمين وظائف مخصصة مباشرة داخل لوحة تحكم Stripe. وهذا القسم دليل بناء: فهو يوثّق كيف يمكن بناء تطبيق كهذا لتكامل Tajo مع Brevo واختباره ونشره.

Caution

الحالة: لم يُنشر بعد. لا يوجد اليوم تطبيق Tajo في متجر تطبيقات Stripe، ومعرّفات التطبيق وعناوين URL وبيانات الاعتماد الواردة في هذه الصفحات أمثلة توضيحية لا نقاط نهاية فعلية. ولربط Stripe بـ Tajo الآن، استخدم موصّل Stripe (مفتاح API مقيّد، مزامنة للقراءة فقط).

Tip

الهدف هو نشر تكامل Brevo في متجر تطبيقات Stripe، بما يتيح لتجار Stripe مزامنة بيانات العملاء والطلبات والأحداث مباشرة إلى Brevo من أجل أتمتة التسويق وCRM.

ما هي تطبيقات Stripe؟

توسّع تطبيقات Stripe لوحة تحكم Stripe بمكوّنات واجهة مخصصة وتكاملات خلفية. وهي تتيح للمطورين الخارجيين:

إضافة عروض مخصصة إلى صفحات لوحة تحكم Stripe (العملاء، المدفوعات، الفواتير، وغيرها)
الوصول إلى بيانات Stripe عبر أذونات محددة النطاق
مزامنة البيانات بين Stripe ومنصات خارجية مثل Brevo
توفير مسارات التهيئة والضبط داخل لوحة التحكم

أهداف تكامل Tajo وBrevo

يربط تطبيق Tajo على Stripe بين Stripe وBrevo ليقدّم:

ذكاء العملاء: مزامنة ملفات عملاء Stripe وسجل المدفوعات والقيمة الدائمة إلى جهات اتصال Brevo
تتبّع الأحداث: دفع أحداث Stripe (المدفوعات والاشتراكات والمبالغ المستردة) بوصفها أحداث معاملات في Brevo
الحملات المؤتمتة: إطلاق حملات البريد الإلكتروني وSMS وواتساب في Brevo استنادًا إلى نشاط Stripe
برامج الولاء: بناء عمليات سير عمل للاحتفاظ بالعملاء باستخدام بيانات الشراء من Stripe المزامَنة إلى Brevo

نظرة عامة على البنية

إلى أين تذهب بيانات تطبيق Stripe

محتويات الدليل

يغطي هذا التوثيق دورة الحياة الكاملة لبناء تطبيق Stripe ونشره:

البدء

الدليل	الوصف
النشر في المتجر	المتطلبات والخطوات لتقديم تطبيقك للمراجعة
متطلبات مراجعة التطبيق	معايير الجودة والأمان وتجربة المستخدم اللازمة للموافقة

الضبط والمرجع

الدليل	الوصف
مرجع App Manifest	المخطط الكامل لملف `stripe-app.json`
مرجع الأذونات	القائمة الكاملة لأذونات Stripe API وكيفية طلبها
مرجع Viewports	مواضع لوحة التحكم التي يمكن أن تظهر فيها واجهة تطبيقك

الميزات والتكامل

الدليل	الوصف
تطبيقات Stripe المضمّنة	استخدام مكوّنات Connect المضمّنة لتكاملات المنصات
روابط التثبيت والروابط العميقة	توليد عناوين URL للتثبيت والربط العميق بعروض محددة في التطبيق
إجراءات ما بعد التثبيت	ضبط مسارات التهيئة بعد تثبيت التطبيق

التشغيل والنمو

الدليل	الوصف
تحليلات التطبيق	تتبّع عمليات التثبيت والمشاهدات ومقاييس التحويل
منظومة الشركاء	الاستفادة من برنامج شركاء Stripe في التسويق المشترك والنمو

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

قبل بناء تطبيق Stripe، تأكد من توفّر:

حساب Stripe: حساب Stripe مفعّل (غير مقيّد بوضع الاختبار)
Stripe CLI: ثبّت Stripe CLI للتطوير المحلي ورفع التطبيقات
Node.js: الإصدار 16 أو أحدث لامتداد واجهة التطبيق
وصول إلى منصة Tajo: حساب Tajo فعّال مع ضبط بيانات اعتماد Brevo API

بداية سريعة

# Install Stripe CLI
brew install stripe/stripe-cli/stripe

# Login to your Stripe account
stripe login

# Create a new Stripe App project
stripe apps create tajo-brevo-integration

# Start local development
stripe apps start

المفاهيم الأساسية

App Manifest

يحتوي كل تطبيق Stripe على ملف stripe-app.json يعلن الأذونات والـ viewports والضبط. راجع مرجع App Manifest للاطلاع على المخطط الكامل.

امتدادات الواجهة

تستطيع تطبيقات Stripe عرض مكوّنات واجهة مبنية على React في viewports محددة داخل لوحة التحكم. وتوفر مجموعة أدوات الواجهة مكوّنات جاهزة تتوافق مع نظام تصميم لوحة تحكم Stripe.

الأذونات

يجب أن تعلن التطبيقات موارد Stripe API المحددة التي تحتاج إلى الوصول إليها. ويوافق المستخدمون على هذه الأذونات أثناء التثبيت. راجع مرجع الأذونات.

سر التوقيع

يحصل كل تطبيق على سر توقيع للتحقق من تواقيع التثبيت وتأمين الاتصال بين خادمك الخلفي وStripe.

سير عمل التطوير

حدّد الـ manifest الخاص بك بالأذونات والـ viewports المطلوبة
ابنِ امتداد الواجهة باستخدام مكتبة مكوّنات React من Stripe
نفّذ نقاط النهاية الخلفية لمزامنة البيانات مع Brevo عبر Tajo
اختبر محليًا باستخدام stripe apps start
ارفع باستخدام stripe apps upload
قدّم التطبيق للمراجعة من لوحة تحكم Stripe
انشر ثم راقب عبر التحليلات