Stripe Apps انٹیگریشن گائیڈ

Stripe Apps آپ کو Stripe Dashboard میں براہ راست کسٹم فعالیت شامل کرنے کی اجازت دیتے ہیں، جس سے merchants کو ادائیگی کے ورک فلو سے باہر گئے بغیر Tajo کی Brevo انٹیگریشن تک رسائی مل جاتی ہے۔ یہ گائیڈ ایک ایسی Stripe App بنانے، جانچنے اور شائع کرنے کے لیے درکار ہر چیز کا احاطہ کرتی ہے جو Tajo کے ذریعے Stripe کو Brevo سے جوڑتی ہے۔

Stripe Apps کیا ہیں؟

Stripe Apps کسٹم UI اجزاء اور بیک اینڈ انٹیگریشن کے ساتھ Stripe Dashboard کو وسعت دیتے ہیں۔ یہ تھرڈ پارٹی ڈویلپرز کو اجازت دیتے ہیں:

• Stripe Dashboard صفحات (گاہکوں، ادائیگیوں، انوائسز وغیرہ) میں کسٹم views شامل کریں
• محدود اجازتوں کے ذریعے Stripe ڈیٹا تک رسائی حاصل کریں
• Stripe اور Brevo جیسے بیرونی پلیٹ فارمز کے درمیان ڈیٹا sync کریں
• Dashboard میں onboarding اور کنفیگریشن فلو فراہم کریں

Tajo + Brevo انٹیگریشن اہداف

Tajo Stripe App Stripe کو Brevo سے جوڑتا ہے اور فراہم کرتا ہے:

• Customer Intelligence: Stripe کسٹمر پروفائلز، ادائیگی کی تاریخ اور lifetime value کو Brevo contacts میں sync کریں
• Event Tracking: Stripe events (ادائیگیاں، سبسکرپشنز، ریفنڈز) کو Brevo transactional events کے طور پر پش کریں
• Automated Campaigns: Stripe سرگرمی کی بنیاد پر Brevo ای میل، SMS اور WhatsApp کمپینز ٹرگر کریں
• Loyalty Programs: Brevo میں sync کردہ Stripe خریداری ڈیٹا کا استعمال کرتے ہوئے retention ورک فلو بنائیں

آرکیٹیکچر کا جائزہ

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  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 App بنانے اور شائع کرنے کے مکمل لائف سائیکل کا احاطہ کرتی ہے:

شروع کرنا

کنفیگریشن اور حوالہ

فیچرز اور انٹیگریشن

آپریشنز اور ترقی

ضروری شرائط

Stripe App بنانے سے پہلے یقینی بنائیں کہ آپ کے پاس ہے:

1. Stripe اکاؤنٹ: ایک فعال Stripe اکاؤنٹ (صرف test موڈ تک محدود نہیں)
2. Stripe CLI: لوکل ڈیولپمنٹ اور app uploads کے لیے Stripe CLI انسٹال کریں
3. Node.js: app UI extension کے لیے ورژن 16 یا اس سے اوپر
4. Tajo Platform تک رسائی: Brevo API کریڈنشیلز کے ساتھ فعال Tajo اکاؤنٹ

فوری آغاز

# Stripe CLI انسٹال کریں
brew install stripe/stripe-cli/stripe

# اپنے Stripe اکاؤنٹ میں لاگ ان کریں
stripe login

# نیا Stripe App پروجیکٹ بنائیں
stripe apps create tajo-brevo-integration

# لوکل ڈیولپمنٹ شروع کریں
stripe apps start

اہم تصورات

App Manifest

ہر Stripe App میں ایک stripe-app.json manifest فائل ہوتی ہے جو اجازتیں، viewports اور کنفیگریشن بیان کرتی ہے۔ مکمل اسکیما کے لیے App Manifest حوالہ دیکھیں۔

UI Extensions

Stripe Apps مخصوص Dashboard viewports میں React-based UI اجزاء render کر سکتے ہیں۔ UI toolkit پہلے سے بنے ہوئے components فراہم کرتا ہے جو Stripe Dashboard ڈیزائن سسٹم سے مطابقت رکھتے ہیں۔

Permissions

Apps کو ان مخصوص Stripe API وسائل کا اعلان کرنا ضروری ہے جن تک انہیں رسائی کی ضرورت ہے۔ صارفین انسٹالیشن کے دوران ان اجازتوں کو منظور کرتے ہیں۔ اجازتوں کا حوالہ دیکھیں۔

Signing Secret

ہر app کو install signatures تصدیق کرنے اور آپ کے بیک اینڈ اور Stripe کے درمیان مواصلات کو محفوظ بنانے کے لیے ایک signing secret ملتا ہے۔

ڈیولپمنٹ ورک فلو

1. تعریف مطلوبہ اجازتوں اور viewports کے ساتھ اپنا manifest بنائیں
2. تعمیر Stripe کی React component library استعمال کرتے ہوئے UI extension
3. نافذ کریں Tajo کے ذریعے Brevo کے ساتھ ڈیٹا sync کے لیے بیک اینڈ endpoints
4. جانچیں stripe apps start استعمال کرکے لوکل ٹیسٹنگ
5. اپلوڈ کریں stripe apps upload کے ساتھ
6. جمع کرائیں Stripe Dashboard کے ذریعے جائزہ کے لیے
7. شائع کریں اور analytics کے ذریعے مانیٹر کریں

اگلے اقدامات

مکمل ضروریات سمجھنے کے لیے شائع کرنے کی گائیڈ سے شروع کریں، پھر اپنے app manifest اور permissions کنفیگر کرنے کے لیے تکنیکی حوالہ جات سے گزریں۔