النشر على متجر تطبيقات Stripe

نشر تطبيق Stripe الخاص بك على المتجر يجعله متاحًا لجميع مستخدمي Stripe. يغطي هذا الدليل المتطلبات وخطوات التحضير وعملية التقديم.

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

قبل أن تتمكن من نشر تطبيق على متجر تطبيقات Stripe، يجب استيفاء هذه المتطلبات:

• حساب Stripe مفعل: لا يمكن أن يكون حسابك مقيدًا بوضع الاختبار فقط
• تطبيق واحد لكل حساب: يمكن لكل حساب Stripe نشر تطبيق عام واحد فقط على المتجر
• باللغة الإنجليزية فقط: يجب أن يكون محتوى التطبيق ونص واجهة المستخدم ومعلومات القائمة باللغة الإنجليزية
• تطبيق مكتمل: يجب أن يكون تطبيقك يعمل بالكامل ومُختبر

خطوات النشر

الخطوة 1: تحديث الـ Manifest

عيّن distribution_type في ملف stripe-app.json إلى 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: تحضير التطبيق

تأكد من أن تطبيقك يستوفي جميع متطلبات المراجعة قبل التقديم:

1. اختبر بدقة في كل من وضع الإنتاج ووضع sandbox
2. تحقق من أن جميع الأذونات ضرورية وموثقة
3. تأكد من تنفيذ معالجة الأخطاء وحالات التحميل
4. تحقق من أن جميع نصوص واجهة المستخدم باللغة الإنجليزية

الخطوة 3: تحميل التطبيق

استخدم Stripe CLI لتحميل تطبيقك:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

الخطوة 4: كتابة القائمة

انتقل إلى لوحة تحكم Stripe لإكمال قائمة تطبيقك. جميع حقول القائمة مطلوبة للتقديم على المتجر.

الخطوة 5: التقديم للمراجعة

بعد إكمال قائمتك، قدم التطبيق للمراجعة من خلال لوحة تحكم Stripe. سيقيّم فريق Stripe تطبيقك وفقًا لـ متطلبات الجودة.

الخطوة 6: النشر

بمجرد الموافقة، يمكنك نشر تطبيقك لجعله متاحًا على المتجر.

إعداد 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"
  }
}

حمّل التطبيق المكوّن باستخدام:

stripe apps upload

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

يجب أن تتضمن قائمة تطبيقك جميع الحقول التالية:

إرشادات الاسم

• يجب أن يكون فريدًا في المتجر
• يجب أن يحدد بوضوح غرض تطبيقك
• تجنب المصطلحات العامة التي قد تربك المستخدمين
• مثال: “Tajo for Brevo” (15 حرفًا)

إرشادات الأيقونة

• الأبعاد: 300x300 بكسل بالضبط
• التنسيق: PNG أو SVG
• لا تضف زوايا دائرية, يطبقها Stripe تلقائيًا
• استخدم شعارًا أو رمزًا واضحًا ومعروفًا
• تأكد من الوضوح بالأحجام الصغيرة

قسم حول

اكتب وصفًا مقنعًا يغطي:

• ما المشكلة التي يحلها تطبيقك
• قدرات التكامل الرئيسية
• لمن صُمم التطبيق
• أي متطلبات أو شروط مسبقة

مثال:

Tajo for Brevo connects your Stripe payment data with Brevo’s marketing automation platform. Automatically sync customers, track payment events, and trigger personalized email, SMS, and WhatsApp campaigns based on real-time purchase behavior. Built for ecommerce businesses that want to maximize customer lifetime value through data-driven retention marketing.

الميزات الرئيسية

يتضمن كل إدخال ميزة:

• العنوان: اسم ميزة قصير
• الوصف: جملة أو جملتان تشرحان الميزة
• الصورة: لقطة شاشة أو مخطط (موصى به 1600x900 بكسل)

الميزات الموصى بها لتكامل Tajo مع Brevo:

1. مزامنة العملاء في الوقت الفعلي, مزامنة ملفات عملاء Stripe تلقائيًا مع جهات اتصال Brevo مع سجل الشراء الكامل
2. الأتمتة القائمة على الأحداث, تفعيل سير عمل Brevo من أحداث Stripe مثل المدفوعات الناجحة وتغييرات الاشتراك والمبالغ المستردة
3. مزامنة كتالوج المنتجات, الحفاظ على تزامن كتالوج منتجات Brevo مع Stripe لمحتوى حملات مخصص
4. حملات متعددة القنوات, استخدام البيانات المتزامنة لتشغيل حملات بريد إلكتروني ورسائل قصيرة وWhatsApp مستهدفة
5. رؤى لوحة التحكم, عرض مقاييس تفاعل Brevo مباشرة في عرض عميل لوحة تحكم Stripe

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

أبلغ بوضوح عن نموذج التسعير:

• مجاني: بدون تكلفة للتثبيت أو الاستخدام
• مدفوع: حدد السعر وتكرار الفوترة
• Freemium: صف ما هو مجاني وما يتطلب الدفع
• قائم على الاستخدام: اشرح مستويات التسعير أو تكاليف الوحدة

اختبار التطبيق

قبل التقديم، اختبر تطبيقك بدقة:

الاختبار في وضع Sandbox

# Start your app in test mode
stripe apps start --mode test

# Verify 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

قائمة التحقق للمراجعة

قبل التقديم، تحقق من:

• التطبيق يعمل في كل من وضع الإنتاج ووضع الاختبار
• جميع الأذونات لها أوصاف غرض واضحة
• حالات الخطأ تُعالج بأناقة
• حالات التحميل تُعرض للعمليات غير المتزامنة
• لا توجد بيانات اختبار مشفرة في بناء الإنتاج
• URL سياسة الخصوصية متاح ودقيق
• معلومات اتصال الدعم صالحة
• جميع صور القائمة تستوفي متطلبات الأبعاد
• وصف التطبيق يعكس الوظائف بدقة

بعد التقديم

يرد فريق مراجعة Stripe عادةً خلال 5-10 أيام عمل. قد:

• يوافقون على تطبيقك للنشر
• يطلبون تغييرات مع ملاحظات محددة
• يرفضون التطبيق إذا لم يستوفِ المتطلبات

إذا طُلبت تغييرات، عالج جميع الملاحظات وأعد التقديم. كل إعادة تقديم تمر بدورة المراجعة الكاملة.

تحديث تطبيق منشور

لتحديث تطبيق منشور مسبقًا:

1. زد الإصدار في stripe-app.json
2. حمّل الإصدار الجديد: stripe apps upload
3. قدم التحديث للمراجعة
4. بمجرد الموافقة، يتم نشر التحديث تلقائيًا لجميع المستخدمين