Publicarea în Stripe App Marketplace

Publicarea aplicației tale Stripe în marketplace o face disponibilă tuturor utilizatorilor Stripe. Acest ghid acoperă cerințele, pașii de pregătire și procesul de trimitere.

Cerințe prealabile

Înainte de a putea publica o aplicație în Stripe App Marketplace, trebuie să îndeplinești aceste cerințe:

• Cont Stripe activat: contul tău nu poate fi limitat doar la modul de testare
• O singură aplicație per cont: fiecare cont Stripe poate publica o singură aplicație publică în marketplace
• Doar în engleză: tot conținutul aplicației, textele din interfață și informațiile din listare trebuie să fie în engleză
• Aplicație finalizată: aplicația ta trebuie să fie complet funcțională și testată

Pașii publicării

Pasul 1: actualizează manifestul

Setează distribution_type din stripe-app.json la 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"
    }
  ]
}

Pasul 2: pregătește aplicația

Asigură-te că aplicația ta îndeplinește toate cerințele de evaluare înainte de a o trimite:

1. Testează temeinic atât în modul live, cât și în sandbox
2. Verifică dacă toate permisiunile sunt necesare și documentate
3. Confirmă că tratarea erorilor și stările de încărcare sunt implementate
4. Verifică dacă toate textele din interfață sunt în engleză

Pasul 3: încarcă aplicația

Folosește Stripe CLI pentru a-ți încărca aplicația:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

Pasul 4: scrie listarea

Mergi în Stripe Dashboard pentru a-ți completa listarea aplicației. Toate câmpurile listării sunt obligatorii pentru trimiterea în marketplace.

Pasul 5: trimite spre evaluare

După ce ți-ai completat listarea, trimite aplicația spre evaluare din Stripe Dashboard. Echipa Stripe îți va evalua aplicația în raport cu cerințele de calitate.

Pasul 6: publică

Odată aprobată, poți publica aplicația pentru a o face disponibilă în marketplace.

Configurarea manifestului pentru distribuție publică

Manifestul trebuie să includă distribution_type: "public" și să declare toate permisiunile necesare, cu descrieri clare ale scopului:

{
  "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"
  }
}

Încarcă aplicația configurată cu:

stripe apps upload

Cerințele listării

Listarea aplicației tale trebuie să includă toate câmpurile următoare:

Recomandări pentru nume

• Trebuie să fie unic în marketplace
• Trebuie să identifice clar scopul aplicației tale
• Evită termenii generici care i-ar putea deruta pe utilizatori
• Exemplu: „Tajo for Brevo” (15 caractere)

Recomandări pentru pictogramă

• Dimensiuni: exact 300x300 pixeli
• Format: PNG sau SVG
• Nu adăuga colțuri rotunjite, Stripe le aplică automat
• Folosește un logo sau un simbol clar, ușor de recunoscut
• Asigură-te că rămâne lizibilă la dimensiuni mici

Secțiunea „Despre”

Scrie o descriere convingătoare, care să acopere:

• Ce problemă rezolvă aplicația ta
• Capabilitățile principale de integrare
• Cui i se adresează aplicația
• Eventualele cerințe prealabile

Exemplu:

Tajo for Brevo conectează datele tale de plată din Stripe cu platforma de automatizare de marketing Brevo. Sincronizează automat clienții, urmărește evenimentele de plată și declanșează campanii personalizate prin e-mail, SMS și WhatsApp, pe baza comportamentului de cumpărare în timp real. Creată pentru afacerile de comerț electronic care vor să maximizeze valoarea pe durata de viață a clientului printr-un marketing de retenție bazat pe date.

Funcționalități principale

Fiecare intrare din lista de funcționalități principale include:

• Titlu: numele scurt al funcționalității
• Descriere: una sau două propoziții care explică funcționalitatea
• Imagine: captură de ecran sau diagramă (recomandat 1600x900 pixeli)

Funcționalități recomandate pentru integrarea Tajo cu Brevo:

1. Sincronizarea clienților în timp real, sincronizează automat profilurile clienților din Stripe către contactele Brevo, cu tot istoricul de achiziții
2. Automatizare bazată pe evenimente, declanșează fluxuri de lucru Brevo pornind de la evenimente Stripe precum plăți reușite, modificări de abonament și rambursări
3. Sincronizarea catalogului de produse, menține catalogul tău de produse din Brevo sincronizat cu Stripe, pentru conținut de campanie personalizat
4. Campanii pe mai multe canale, folosește datele sincronizate pentru campanii țintite prin e-mail, SMS și WhatsApp
5. Analize în panoul de administrare, vezi indicatorii de implicare din Brevo direct în vizualizarea clientului din Stripe Dashboard

Informații despre prețuri

Comunică limpede modelul tău de preț:

• Gratuit: fără costuri de instalare sau de utilizare
• Cu plată: precizează prețul și frecvența facturării
• Freemium: descrie ce este inclus gratuit și ce necesită plată
• Bazat pe utilizare: explică nivelurile de preț sau costurile pe unitate

Testarea aplicației

Înainte de trimitere, testează-ți temeinic aplicația:

Testează în modul sandbox

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

# Verify sandbox compatibility
stripe apps validate

Formatul credențialelor de test

Când furnizezi credențiale de test echipei de evaluare, folosește acest format:

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

Listă de verificare înainte de evaluare

Înainte de a trimite aplicația, verifică:

• Aplicația funcționează atât în modul live, cât și în modul de testare
• Toate permisiunile au descrieri clare ale scopului
• Stările de eroare sunt tratate elegant
• Stările de încărcare sunt afișate pentru operațiunile asincrone
• Nu există date de test scrise în cod în build-ul de producție
• URL-ul politicii de confidențialitate este accesibil și corect
• Datele de contact pentru asistență sunt valide
• Toate imaginile din listare respectă cerințele de dimensiune
• Descrierea aplicației reflectă corect funcționalitatea

După trimitere

Echipa de evaluare Stripe răspunde de obicei în 5-10 zile lucrătoare. Ea poate:

• Aproba aplicația ta pentru publicare
• Cere modificări, cu observații concrete
• Respinge aplicația dacă nu îndeplinește cerințele

Dacă ți se cer modificări, rezolvă toate observațiile și trimite aplicația din nou. Fiecare retrimitere parcurge întregul ciclu de evaluare.

Actualizarea unei aplicații publicate

Pentru a actualiza o aplicație deja publicată:

1. Incrementează versiunea din stripe-app.json
2. Încarcă noua versiune: stripe apps upload
3. Trimite actualizarea spre evaluare
4. Odată aprobată, actualizarea este livrată automat tuturor utilizatorilor