Objavljivanje na Stripe App Marketplace

Objavljivanjem vaše Stripe aplikacije na marketplace-u ona postaje dostupna svim Stripe korisnicima. Ovo uputstvo pokriva zahteve, korake pripreme i proces slanja na pregled.

Preduslovi

Pre nego što aplikaciju objavite na Stripe App Marketplace-u, morate ispuniti sledeće zahteve:

• Aktiviran Stripe nalog: vaš nalog ne sme biti ograničen samo na test režim
• Jedna aplikacija po nalogu: svaki Stripe nalog može objaviti samo jednu javnu aplikaciju na marketplace-u
• Samo engleski: sav sadržaj aplikacije, tekst u interfejsu i podaci u opisu moraju biti na engleskom
• Završena aplikacija: vaša aplikacija mora biti potpuno funkcionalna i testirana

Koraci objavljivanja

Korak 1: Ažurirajte svoj manifest

Postavite distribution_type u fajlu stripe-app.json na 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"
    }
  ]
}

Korak 2: Pripremite svoju aplikaciju

Uverite se da vaša aplikacija ispunjava sve zahteve za pregled pre nego što je pošaljete:

1. Detaljno testirajte i u live i u sandbox režimu
2. Proverite da li su sve dozvole neophodne i dokumentovane
3. Potvrdite da su obrada grešaka i stanja učitavanja implementirani
4. Proverite da li je sav tekst u interfejsu na engleskom

Korak 3: Otpremite svoju aplikaciju

Za otpremanje aplikacije koristite Stripe CLI:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

Korak 4: Napišite svoj opis na marketplace-u

Otvorite Stripe Dashboard da biste popunili opis svoje aplikacije. Sva polja opisa obavezna su za slanje na marketplace.

Korak 5: Pošaljite na pregled

Kada popunite opis, pošaljite aplikaciju na pregled kroz Stripe Dashboard. Stripe tim će oceniti vašu aplikaciju u odnosu na zahteve kvaliteta.

Korak 6: Objavite

Kada aplikacija bude odobrena, možete je objaviti i time učiniti dostupnom na marketplace-u.

Podešavanje manifesta za javnu distribuciju

Manifest mora da sadrži distribution_type: "public" i da deklariše sve potrebne dozvole uz jasan opis njihove svrhe:

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

Otpremite konfigurisanu aplikaciju komandom:

stripe apps upload

Zahtevi za opis aplikacije

Opis vaše aplikacije mora da sadrži sva sledeća polja:

Smernice za ime

• Mora biti jedinstveno na marketplace-u
• Treba jasno da ukazuje na svrhu vaše aplikacije
• Izbegavajte uopštene izraze koji mogu da zbune korisnike
• Primer: „Tajo for Brevo” (15 znakova)

Smernice za ikonu

• Dimenzije: tačno 300x300 piksela
• Format: PNG ili SVG
• Nemojte da dodajete zaobljene uglove, Stripe ih primenjuje automatski
• Koristite jasan i prepoznatljiv logotip ili simbol
• Obezbedite čitljivost i u malim veličinama

Odeljak „About”

Napišite ubedljiv opis koji pokriva:

• Koji problem vaša aplikacija rešava
• Ključne mogućnosti integracije
• Kome je aplikacija namenjena
• Sve preduslove ili zahteve

Primer:

Tajo for Brevo povezuje vaše podatke o Stripe plaćanjima sa Brevo platformom za marketinšku automatizaciju. Automatski sinhronizujte kupce, pratite događaje plaćanja i pokrećite personalizovane imejl, SMS i WhatsApp kampanje na osnovu ponašanja pri kupovini u realnom vremenu. Napravljeno za kompanije u e-trgovini koje žele da povećaju životnu vrednost kupca kroz marketing zadržavanja zasnovan na podacima.

Ključne funkcije

Svaki unos u ključnim funkcijama sadrži:

• Naslov: kratak naziv funkcije
• Opis: jedna do dve rečenice koje objašnjavaju funkciju
• Slika: snimak ekrana ili dijagram (preporučeno 1600x900 piksela)

Preporučene funkcije za Tajo integraciju sa Brevom:

1. Sinhronizacija kupaca u realnom vremenu, automatski sinhronizujte Stripe profile kupaca sa Brevo kontaktima, uz kompletnu istoriju kupovine
2. Automatizacija pokrenuta događajima, pokrećite Brevo tokove rada iz Stripe događaja kao što su uspešna plaćanja, promene pretplate i povraćaji sredstava
3. Sinhronizacija kataloga proizvoda, održavajte svoj Brevo katalog proizvoda usklađenim sa Stripe-om radi personalizovanog sadržaja kampanja
4. Višekanalne kampanje, koristite sinhronizovane podatke za ciljane imejl, SMS i WhatsApp kampanje
5. Uvidi u komandnoj tabli, pregledajte Brevo metrike angažovanja direktno u prikazu kupca u Stripe Dashboard-u

Informacije o cenama

Jasno saopštite svoj model naplate:

• Besplatno: instalacija i korišćenje bez troškova
• Plaćeno: navedite cenu i učestalost naplate
• Freemium: opišite šta je uključeno besplatno, a šta se plaća
• Na osnovu potrošnje: objasnite cenovne nivoe ili cenu po jedinici

Testiranje vaše aplikacije

Pre slanja na pregled detaljno testirajte svoju aplikaciju:

Testirajte u sandbox režimu

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

# Verify sandbox compatibility
stripe apps validate

Format test akreditiva

Kada pregledačkom timu dostavljate test akreditive, koristite ovaj 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

Kontrolna lista pre pregleda

Pre slanja proverite sledeće:

• Aplikacija radi i u live i u test režimu
• Sve dozvole imaju jasan opis svrhe
• Stanja grešaka su obrađena na odgovarajući način
• Stanja učitavanja se prikazuju za asinhrone operacije
• U produkcijskoj verziji nema test podataka upisanih u kod
• URL politike privatnosti je dostupan i tačan
• Kontakt podaci podrške su ispravni
• Sve slike u opisu ispunjavaju zahteve dimenzija
• Opis aplikacije tačno odražava njenu funkcionalnost

Posle slanja

Stripe tim za pregled obično odgovara u roku od 5-10 radnih dana. Oni mogu da:

• odobre vašu aplikaciju za objavljivanje
• zatraže izmene uz konkretne povratne informacije
• odbiju aplikaciju ako ne ispunjava zahteve

Ako su zatražene izmene, odgovorite na sve primedbe i pošaljite aplikaciju ponovo. Svako ponovno slanje prolazi kroz kompletan ciklus pregleda.

Ažuriranje objavljene aplikacije

Da biste ažurirali već objavljenu aplikaciju:

1. Povećajte verziju u fajlu stripe-app.json
2. Otpremite novu verziju: stripe apps upload
3. Pošaljite ažuriranje na pregled
4. Kada bude odobreno, ažuriranje se automatski isporučuje svim korisnicima