Stripe App Marketplace पर पब्लिश करना

अपने Stripe App को मार्केटप्लेस पर पब्लिश करने से वह सभी Stripe यूज़र के लिए उपलब्ध हो जाता है. यह गाइड ज़रूरी शर्तों, तैयारी के चरणों और सबमिशन की प्रक्रिया को कवर करती है.

पूर्वापेक्षाएं

Stripe App Marketplace पर ऐप पब्लिश करने से पहले आपको ये शर्तें पूरी करनी होंगी:

• सक्रिय Stripe अकाउंट: आपका अकाउंट केवल टेस्ट मोड तक सीमित नहीं होना चाहिए
• एक अकाउंट पर एक ऐप: हर Stripe अकाउंट मार्केटप्लेस पर केवल एक पब्लिक ऐप पब्लिश कर सकता है
• केवल अंग्रेज़ी: ऐप की सारी सामग्री, UI टेक्स्ट और लिस्टिंग की जानकारी अंग्रेज़ी में होनी चाहिए
• पूरा बना हुआ ऐप: आपका ऐप पूरी तरह काम करने लायक और टेस्ट किया हुआ होना चाहिए

पब्लिश करने के चरण

चरण 1: अपना मैनिफ़ेस्ट अपडेट करें

अपनी 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: अपना ऐप तैयार करें

सबमिट करने से पहले पक्का करें कि आपका ऐप सभी रिव्यू शर्तों पर खरा उतरता है:

1. लाइव और सैंडबॉक्स दोनों मोड में अच्छी तरह टेस्ट करें
2. पुष्टि करें कि सभी अनुमतियां ज़रूरी हैं और उनका दस्तावेज़ीकरण है
3. जांचें कि एरर हैंडलिंग और लोडिंग स्टेट लागू किए गए हैं
4. देखें कि सारा UI टेक्स्ट अंग्रेज़ी में है

चरण 3: अपना ऐप अपलोड करें

अपना ऐप अपलोड करने के लिए Stripe CLI का उपयोग करें:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

चरण 4: अपनी लिस्टिंग लिखें

अपनी ऐप लिस्टिंग पूरी करने के लिए Stripe डैशबोर्ड पर जाएं. मार्केटप्लेस सबमिशन के लिए लिस्टिंग के सभी फ़ील्ड ज़रूरी हैं.

चरण 5: रिव्यू के लिए सबमिट करें

अपनी लिस्टिंग पूरी करने के बाद, Stripe डैशबोर्ड से ऐप को रिव्यू के लिए सबमिट करें. Stripe की टीम आपके ऐप का मूल्यांकन क्वालिटी शर्तों के आधार पर करेगी.

चरण 6: पब्लिश करें

मंज़ूरी मिलने के बाद, आप अपना ऐप पब्लिश करके उसे मार्केटप्लेस पर उपलब्ध करा सकते हैं.

पब्लिक डिस्ट्रिब्यूशन के लिए मैनिफ़ेस्ट सेटअप

मैनिफ़ेस्ट में 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 उन्हें अपने आप लागू करता है
• एक साफ़, पहचानने योग्य लोगो या प्रतीक का उपयोग करें
• पक्का करें कि छोटे आकार में भी पढ़ा जा सके

About सेक्शन

एक असरदार विवरण लिखें जिसमें ये बातें शामिल हों:

• आपका ऐप किस समस्या को हल करता है
• मुख्य इंटीग्रेशन क्षमताएं
• ऐप किसके लिए बनाया गया है
• कोई पूर्वापेक्षाएं या शर्तें

उदाहरण:

Tajo for Brevo आपके Stripe पेमेंट डेटा को Brevo के मार्केटिंग ऑटोमेशन प्लेटफ़ॉर्म से जोड़ता है. ग्राहकों को अपने आप सिंक करें, पेमेंट इवेंट ट्रैक करें, और रीयल-टाइम ख़रीदारी व्यवहार के आधार पर व्यक्तिगत ईमेल, SMS और व्हाट्सऐप कैम्पेन ट्रिगर करें. यह उन ई-कॉमर्स कारोबारों के लिए बनाया गया है जो डेटा-आधारित रिटेंशन मार्केटिंग से ग्राहक की लाइफ़टाइम वैल्यू बढ़ाना चाहते हैं.

मुख्य फ़ीचर

हर मुख्य फ़ीचर की एंट्री में ये शामिल होते हैं:

• शीर्षक: फ़ीचर का छोटा नाम
• विवरण: फ़ीचर को समझाने वाले एक से दो वाक्य
• इमेज: स्क्रीनशॉट या डायग्राम (सुझाया गया 1600x900 पिक्सेल)

Tajo Brevo इंटीग्रेशन के लिए सुझाए गए फ़ीचर:

1. रीयल-टाइम कस्टमर सिंक, Stripe के ग्राहक प्रोफ़ाइल को पूरी ख़रीदारी हिस्ट्री के साथ अपने आप Brevo कॉन्टैक्ट में सिंक करें
2. इवेंट-आधारित ऑटोमेशन, सफल पेमेंट, सब्सक्रिप्शन में बदलाव और रिफ़ंड जैसे Stripe इवेंट से Brevo वर्कफ़्लो ट्रिगर करें
3. प्रोडक्ट कैटलॉग सिंक, व्यक्तिगत कैम्पेन सामग्री के लिए अपने Brevo प्रोडक्ट कैटलॉग को Stripe के साथ सिंक रखें
4. मल्टी-चैनल कैम्पेन, सिंक किए गए डेटा से लक्षित ईमेल, SMS और व्हाट्सऐप कैम्पेन चलाएं
5. डैशबोर्ड इनसाइट, Brevo के एंगेजमेंट मेट्रिक सीधे Stripe डैशबोर्ड के कस्टमर व्यू में देखें

प्राइसिंग की जानकारी

अपना प्राइसिंग मॉडल साफ़ तौर पर बताएं:

• मुफ़्त: इंस्टॉल करने या उपयोग करने का कोई शुल्क नहीं
• पेड: कीमत और बिलिंग की आवृत्ति बताएं
• फ़्रीमियम: बताएं कि क्या मुफ़्त है और किसके लिए भुगतान करना होगा
• उपयोग-आधारित: प्राइसिंग टियर या प्रति-यूनिट लागत समझाएं

अपने ऐप की टेस्टिंग

सबमिट करने से पहले, अपने ऐप को अच्छी तरह टेस्ट करें:

सैंडबॉक्स मोड में टेस्ट करें

# 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. मंज़ूरी मिलने पर, अपडेट अपने आप सभी यूज़र तक पहुंच जाता है