Δημοσίευση στο Stripe App Marketplace

Η δημοσίευση της εφαρμογής σας Stripe στο marketplace την καθιστά διαθέσιμη σε όλους τους χρήστες του Stripe. Αυτός ο οδηγός καλύπτει τις προϋποθέσεις, τα βήματα προετοιμασίας και τη διαδικασία υποβολής.

Προϋποθέσεις

Πριν δημοσιεύσετε μια εφαρμογή στο Stripe App Marketplace, πρέπει να πληροίτε τις εξής προϋποθέσεις:

• Ενεργοποιημένος λογαριασμός Stripe: ο λογαριασμός σας δεν πρέπει να περιορίζεται μόνο σε λειτουργία δοκιμών
• Μία εφαρμογή ανά λογαριασμό: κάθε λογαριασμός Stripe μπορεί να δημοσιεύσει μόνο μία δημόσια εφαρμογή στο marketplace
• Μόνο στα αγγλικά: όλο το περιεχόμενο της εφαρμογής, τα κείμενα της διεπαφής και οι πληροφορίες της καταχώρισης πρέπει να είναι στα αγγλικά
• Ολοκληρωμένη εφαρμογή: η εφαρμογή σας πρέπει να είναι πλήρως λειτουργική και δοκιμασμένη

Βήματα δημοσίευσης

Βήμα 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 για να ολοκληρώσετε την καταχώριση της εφαρμογής σας. Όλα τα πεδία της καταχώρισης είναι υποχρεωτικά για την υποβολή στο marketplace.

Βήμα 5: Υποβάλετε για αξιολόγηση

Αφού ολοκληρώσετε την καταχώρισή σας, υποβάλετε την εφαρμογή για αξιολόγηση μέσω του πίνακα ελέγχου του Stripe. Η ομάδα του Stripe θα αξιολογήσει την εφαρμογή σας με βάση τις απαιτήσεις ποιότητας.

Βήμα 6: Δημοσιεύστε

Μόλις εγκριθεί, μπορείτε να δημοσιεύσετε την εφαρμογή σας ώστε να είναι διαθέσιμη στο 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"
  }
}

Ανεβάστε τη διαμορφωμένη εφαρμογή με:

stripe apps upload

Απαιτήσεις καταχώρισης

Η καταχώριση της εφαρμογής σας πρέπει να περιλαμβάνει όλα τα παρακάτω πεδία:

Οδηγίες για το όνομα

• Πρέπει να είναι μοναδικό στο marketplace
• Πρέπει να δηλώνει με σαφήνεια τον σκοπό της εφαρμογής σας
• Αποφύγετε γενικόλογους όρους που μπορεί να μπερδέψουν τους χρήστες
• Παράδειγμα: «Tajo for Brevo» (15 χαρακτήρες)

Οδηγίες για το εικονίδιο

• Διαστάσεις: ακριβώς 300x300 pixel
• Μορφή: PNG ή SVG
• Μην προσθέτετε στρογγυλεμένες γωνίες, το Stripe τις εφαρμόζει αυτόματα
• Χρησιμοποιήστε ένα καθαρό, αναγνωρίσιμο λογότυπο ή σύμβολο
• Φροντίστε να είναι ευανάγνωστο σε μικρά μεγέθη

Ενότητα «Σχετικά»

Γράψτε μια πειστική περιγραφή που καλύπτει:

• Ποιο πρόβλημα λύνει η εφαρμογή σας
• Τις βασικές δυνατότητες ενσωμάτωσης
• Σε ποιους απευθύνεται η εφαρμογή
• Τυχόν προϋποθέσεις ή απαιτήσεις

Παράδειγμα:

Το Tajo for Brevo συνδέει τα δεδομένα πληρωμών σας από το Stripe με την πλατφόρμα αυτοματοποίησης μάρκετινγκ του Brevo. Συγχρονίστε αυτόματα πελάτες, παρακολουθήστε συμβάντα πληρωμών και ενεργοποιήστε εξατομικευμένες καμπάνιες email, SMS και WhatsApp με βάση την αγοραστική συμπεριφορά σε πραγματικό χρόνο. Σχεδιασμένο για επιχειρήσεις ηλεκτρονικού εμπορίου που θέλουν να μεγιστοποιήσουν τη διαχρονική αξία των πελατών τους μέσω μάρκετινγκ διατήρησης βασισμένου σε δεδομένα.

Βασικές δυνατότητες

Κάθε καταχώριση βασικής δυνατότητας περιλαμβάνει:

• Τίτλο: σύντομο όνομα της δυνατότητας
• Περιγραφή: μία ή δύο προτάσεις που εξηγούν τη δυνατότητα
• Εικόνα: στιγμιότυπο ή διάγραμμα (συνιστώνται 1600x900 pixel)

Προτεινόμενες δυνατότητες για την ενσωμάτωση Tajo Brevo:

1. Συγχρονισμός πελατών σε πραγματικό χρόνο, συγχρονίστε αυτόματα τα προφίλ πελατών του Stripe με τις επαφές του Brevo, μαζί με το πλήρες ιστορικό αγορών
2. Αυτοματοποίηση με βάση τα συμβάντα, ενεργοποιήστε ροές εργασίας του Brevo από συμβάντα του Stripe, όπως επιτυχείς πληρωμές, αλλαγές συνδρομής και επιστροφές χρημάτων
3. Συγχρονισμός καταλόγου προϊόντων, διατηρήστε τον κατάλογο προϊόντων του Brevo συγχρονισμένο με το Stripe για εξατομικευμένο περιεχόμενο καμπανιών
4. Καμπάνιες πολλαπλών καναλιών, αξιοποιήστε τα συγχρονισμένα δεδομένα για στοχευμένες καμπάνιες email, SMS και 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. Μόλις εγκριθεί, η ενημέρωση αναπτύσσεται αυτόματα σε όλους τους χρήστες