Stripe App Marketplace پر شائع کرنا

اپنی Stripe App کو marketplace پر شائع کرنے سے یہ تمام Stripe صارفین کے لیے دستیاب ہو جاتی ہے۔ یہ گائیڈ ضروریات، تیاری کے اقدامات اور جمع کرانے کے عمل کا احاطہ کرتی ہے۔

ضروری شرائط

Stripe App Marketplace پر app شائع کرنے سے پہلے، آپ کو یہ ضروریات پوری کرنی ہوں گی:

• فعال Stripe اکاؤنٹ: آپ کا اکاؤنٹ صرف test موڈ تک محدود نہیں ہو سکتا
• فی اکاؤنٹ ایک app: ہر Stripe اکاؤنٹ صرف ایک عوامی app marketplace پر شائع کر سکتا ہے
• صرف انگریزی: تمام app مواد، UI متن اور listing معلومات انگریزی میں ہونی چاہئیں
• مکمل app: آپ کی app مکمل طور پر کام کرنے والی اور جانچی ہوئی ہونی چاہیے

شائع کرنے کے اقدامات

اقدام 1: Manifest اپ ڈیٹ کریں

stripe-app.json میں distribution_type کو public پر سیٹ کریں:

{
  "id": "com.tajo.brevo-integration",
  "version": "1.0.0",
  "name": "Tajo Brevo Integration",
  "icon": "./icon.png",
  "distribution_type": "public",
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Sync customer data to Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Update customer metadata with Brevo sync status"
    },
    {
      "permission": "event_read",
      "purpose": "Track payment and subscription events for Brevo automation"
    }
  ]
}

اقدام 2: App تیار کریں

جمع کرانے سے پہلے یقینی بنائیں کہ آپ کی app تمام جائزہ ضروریات پوری کرتی ہے:

1. live اور sandbox دونوں موڈز میں اچھی طرح جانچیں
2. تصدیق کریں کہ تمام اجازتیں ضروری ہیں اور دستاویزی ہیں
3. تصدیق کریں کہ error handling اور loading states نافذ ہیں
4. جانچیں کہ تمام UI متن انگریزی میں ہے

اقدام 3: App اپلوڈ کریں

Stripe CLI استعمال کرکے app اپلوڈ کریں:

# app کو Stripe پر اپلوڈ کریں
stripe apps upload

# اپلوڈ کی تصدیق کریں
stripe apps versions list

اقدام 4: Listing لکھیں

اپنی app listing مکمل کرنے کے لیے Stripe Dashboard پر جائیں۔ marketplace جمع کرانے کے لیے تمام listing fields ضروری ہیں۔

اقدام 5: جائزہ کے لیے جمع کرائیں

اپنی listing مکمل کرنے کے بعد، Stripe Dashboard کے ذریعے app کو جائزہ کے لیے جمع کرائیں۔ Stripe ٹیم آپ کی app کا معیار ضروریات کے خلاف جائزہ لے گی۔

اقدام 6: شائع کریں

منظوری کے بعد، آپ اپنی app شائع کر سکتے ہیں تاکہ یہ marketplace پر دستیاب ہو جائے۔

عوامی تقسیم کے لیے Manifest سیٹ اپ

Manifest میں distribution_type: "public" شامل ہونا چاہیے اور واضح مقصد کی وضاحت کے ساتھ تمام ضروری اجازتیں بیان کی جانی چاہئیں:

{
  "id": "com.tajo.brevo-integration",
  "version": "1.2.0",
  "name": "Tajo for Brevo",
  "icon": "./assets/icon.png",
  "distribution_type": "public",
  "stripe_api_access_type": "oauth",
  "allowed_redirect_uris": [
    "https://tajo.io/stripe/callback"
  ],
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Read customer profiles to sync with Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Write sync metadata to customer records"
    },
    {
      "permission": "charge_read",
      "purpose": "Access payment data for Brevo event tracking"
    },
    {
      "permission": "event_read",
      "purpose": "Subscribe to Stripe events for real-time Brevo sync"
    },
    {
      "permission": "product_read",
      "purpose": "Sync product catalog to Brevo for campaign personalization"
    },
    {
      "permission": "invoice_read",
      "purpose": "Track invoice events for Brevo transactional emails"
    }
  ],
  "ui_extension": {
    "views": [
      {
        "viewport": "stripe.dashboard.customer.detail",
        "component": "CustomerDetailView"
      },
      {
        "viewport": "stripe.dashboard.home.overview",
        "component": "OverviewView"
      }
    ]
  },
  "post_install_action": {
    "type": "onboarding"
  }
}

کنفیگر شدہ app کو اپلوڈ کریں:

stripe apps upload

Listing کی ضروریات

آپ کی app listing میں درج ذیل تمام fields شامل ہونے چاہئیں:

نام کی ہدایات

• marketplace پر منفرد ہونا چاہیے
• app کا مقصد واضح طور پر بیان کرنا چاہیے
• ایسی عام اصطلاحات سے گریز کریں جو صارفین کو الجھا سکتی ہیں
• مثال: “Tajo for Brevo” (15 حروف)

آئیکن کی ہدایات

• جہت: بالکل 300x300 پکسل
• فارمیٹ: PNG یا SVG
• گول کنارے مت شامل کریں, Stripe خود بخود شامل کرتا ہے
• واضح، پہچاننے والا لوگو یا علامت استعمال کریں
• چھوٹے سائز پر پڑھنے کے قابل ہونا یقینی بنائیں

تعارف کا حصہ

ایک دلچسپ وضاحت لکھیں جو کا احاطہ کرے:

• app کون سا مسئلہ حل کرتی ہے
• اہم انٹیگریشن صلاحیتیں
• app کس کے لیے ڈیزائن کی گئی ہے
• کوئی بھی ضروری شرائط یا تقاضے

مثال:

Tajo for Brevo آپ کے Stripe ادائیگی ڈیٹا کو Brevo کے مارکیٹنگ آٹومیشن پلیٹ فارم سے جوڑتا ہے۔ حقیقی وقت خریداری رویے کی بنیاد پر خودکار طور پر گاہکوں کو sync کریں، ادائیگی کے events ٹریک کریں، اور ذاتی ای میل، SMS اور WhatsApp کمپینز ٹرگر کریں۔ ان ای کامرس کاروباروں کے لیے بنایا گیا ہے جو ڈیٹا پر مبنی retention marketing کے ذریعے customer lifetime value کو زیادہ سے زیادہ کرنا چاہتے ہیں۔

App کی جانچ

جمع کرانے سے پہلے، اپنی app کی اچھی طرح جانچ کریں:

Sandbox موڈ میں جانچ

# test موڈ میں app شروع کریں
stripe apps start --mode test

# sandbox compatibility تصدیق کریں
stripe apps validate

جانچ کی اسناد کا فارمیٹ

جائزہ ٹیم کو جانچ کی اسناد فراہم کرتے وقت یہ فارمیٹ استعمال کریں:

Test Account Credentials
========================
Platform: Tajo
URL: https://app.tajo.io/test
Email: [email protected]
Password: [secure test password]

Brevo Test API Key: xkeysib-test-xxxxxxxxxxxx

Required Setup Steps:
1. Log in to the Tajo test account
2. Navigate to Settings > Integrations > Brevo
3. The Brevo API key is pre-configured
4. Install the Stripe App from the test link provided

Expected Behavior:
- Customer sync should begin within 60 seconds of installation
- Navigate to any Stripe customer to see Brevo contact data
- Create a test payment to verify event sync to Brevo

جائزہ چیک لسٹ

جمع کرانے سے پہلے تصدیق کریں:

• app live اور test دونوں موڈز میں کام کرتی ہے
• تمام اجازتوں میں واضح مقصد کی وضاحت ہے
• error states کو اچھی طرح سنبھالا گیا ہے
• async آپریشنز کے لیے loading states دکھائی جاتی ہیں
• production build میں کوئی hardcoded test ڈیٹا نہیں
• پرائیویسی پالیسی URL قابل رسائی اور درست ہے
• سپورٹ رابطہ معلومات درست ہے
• تمام listing تصویریں جہت کی ضروریات پوری کرتی ہیں
• app کی وضاحت صحیح طور پر فعالیت کی عکاسی کرتی ہے

جمع کرانے کے بعد

Stripe جائزہ ٹیم عام طور پر 5-10 کاروباری دنوں میں جواب دیتی ہے۔ وہ کر سکتے ہیں:

• آپ کی app کو اشاعت کے لیے منظور کریں
• مخصوص تاثرات کے ساتھ تبدیلیوں کی درخواست کریں
• اگر app ضروریات پوری نہیں کرتی تو مسترد کریں

اگر تبدیلیاں مانگی جائیں تو تمام تاثرات پر عمل کریں اور دوبارہ جمع کرائیں۔ ہر دوبارہ جمع کرانے پر مکمل جائزہ سائیکل سے گزرنا ہوگا۔

شائع شدہ App کو اپ ڈیٹ کرنا

پہلے سے شائع app کو اپ ڈیٹ کرنے کے لیے:

1. stripe-app.json میں ورژن بڑھائیں
2. نیا ورژن اپلوڈ کریں: stripe apps upload
3. اپ ڈیٹ جائزہ کے لیے جمع کرائیں
4. منظوری کے بعد، اپ ڈیٹ خود بخود تمام صارفین کے لیے تعینات ہو جاتی ہے