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

تتيح لك تطبيقات Stripe تضمين وظائف مخصصة مباشرة في لوحة تحكم Stripe، مما يمنح التجار إمكانية الوصول إلى تكامل Tajo مع Brevo دون مغادرة سير عمل المدفوعات. يغطي هذا الدليل كل ما تحتاجه لبناء واختبار ونشر تطبيق Stripe يربط بين Stripe و Brevo من خلال Tajo.

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

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

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

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

يربط تطبيق Tajo لـ Stripe بين Stripe و Brevo لتقديم:

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

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

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Stripe Dashboard │────▶│   Tajo Platform  │────▶│     Brevo       │
│  (Stripe App UI) │◀────│   (Middleware)    │◀────│   (CRM/Email)   │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                        │                        │
   Customer views          Data sync &              Contacts,
   Payment details         Event routing            Campaigns,
   App settings            Webhook handling         Automations

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

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

البدء

التكوين والمرجع

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

العمليات والنمو

المتطلبات الأساسية

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

1. حساب Stripe: حساب Stripe مفعل (غير مقيد بوضع الاختبار)
2. Stripe CLI: تثبيت Stripe CLI للتطوير المحلي وتحميل التطبيقات
3. Node.js: الإصدار 16 أو أحدث لامتداد واجهة التطبيق
4. وصول لمنصة 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.

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

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

الخطوات التالية

ابدأ بـ دليل النشر لفهم المتطلبات الكاملة، ثم اعمل من خلال المراجع التقنية لتكوين manifest التطبيق والأذونات.