Objava aplikacije na tržnici Stripe App Marketplace

Objavom vaše Stripe aplikacije na tržnici ona postaje dostupna svim korisnicima Stripea. Ovaj vodič pokriva zahtjeve, korake pripreme i postupak predaje.

Preduvjeti

Prije nego što aplikaciju možete objaviti na tržnici Stripe App Marketplace, morate ispuniti sljedeće zahtjeve:

• Aktiviran Stripe račun: vaš račun ne smije biti ograničen isključivo na testni način rada
• Jedna aplikacija po računu: svaki Stripe račun može objaviti samo jednu javnu aplikaciju na tržnici
• Samo engleski jezik: sav sadržaj aplikacije, tekst sučelja i podaci o oglasu moraju biti na engleskom
• Dovršena aplikacija: vaša aplikacija mora biti potpuno funkcionalna i testirana

Koraci objave

Korak 1: Ažurirajte svoj manifest

Postavite distribution_type u datoteci 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

Prije predaje provjerite ispunjava li vaša aplikacija sve zahtjeve za pregled:

1. Temeljito testirajte u načinu rada uživo i u sandbox načinu
2. Provjerite jesu li sva dopuštenja nužna i dokumentirana
3. Potvrdite da su obrada pogrešaka i stanja učitavanja implementirani
4. Provjerite je li sav tekst sučelja na engleskom

Korak 3: Prenesite svoju aplikaciju

Za prijenos aplikacije upotrijebite Stripe CLI:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

Korak 4: Napišite svoj oglas

Otvorite Stripe Dashboard kako biste dovršili oglas za svoju aplikaciju. Sva polja oglasa obavezna su za predaju na tržnicu.

Korak 5: Predajte na pregled

Nakon što dovršite oglas, predajte aplikaciju na pregled putem Stripe Dashboarda. Tim platforme Stripe ocijenit će vašu aplikaciju prema zahtjevima kvalitete.

Korak 6: Objavite

Nakon odobrenja možete objaviti svoju aplikaciju kako bi postala dostupna na tržnici.

Postavljanje manifesta za javnu distribuciju

Manifest mora sadržavati distribution_type: "public" i deklarirati sva potrebna dopuštenja s jasnim opisima 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"
  }
}

Konfiguriranu aplikaciju prenesite naredbom:

stripe apps upload

Zahtjevi za oglas

Oglas vaše aplikacije mora sadržavati sva sljedeća polja:

Smjernice za naziv

• Mora biti jedinstven na tržnici
• Treba jasno označavati svrhu vaše aplikacije
• Izbjegavajte općenite izraze koji bi mogli zbuniti korisnike
• Primjer: „Tajo for Brevo” (15 znakova)

Smjernice za ikonu

• Dimenzije: točno 300x300 piksela
• Format: PNG ili SVG
• Ne dodajte zaobljene kutove, Stripe ih primjenjuje automatski
• Upotrijebite jasan i prepoznatljiv logotip ili simbol
• Osigurajte čitljivost u malim veličinama

Odjeljak „O aplikaciji”

Napišite uvjerljiv opis koji obuhvaća:

• Koji problem vaša aplikacija rješava
• Ključne mogućnosti integracije
• Kome je aplikacija namijenjena
• Sve preduvjete ili zahtjeve

Primjer:

Tajo for Brevo povezuje vaše Stripe podatke o plaćanjima s platformom za marketinšku automatizaciju Brevo. Automatski sinkronizirajte kupce, pratite događaje plaćanja i pokrećite personalizirane kampanje e-pošte, SMS-a i WhatsAppa na temelju stvarnog ponašanja pri kupnji. Namijenjeno e-commerce tvrtkama koje žele maksimalno povećati životnu vrijednost kupca kroz marketing zadržavanja utemeljen na podacima.

Ključne značajke

Svaki unos ključne značajke sadrži:

• Naslov: kratak naziv značajke
• Opis: jedna do dvije rečenice koje objašnjavaju značajku
• Slika: snimka zaslona ili dijagram (preporučeno 1600x900 piksela)

Preporučene značajke za Tajo Brevo integraciju:

1. Sinkronizacija kupaca u stvarnom vremenu, automatski sinkronizirajte profile Stripe kupaca s Brevo kontaktima uz cjelovitu povijest kupnji
2. Automatizacija vođena događajima, pokrenite Brevo tijekove rada iz Stripe događaja poput uspješnih plaćanja, promjena pretplate i povrata
3. Sinkronizacija kataloga proizvoda, održavajte svoj Brevo katalog proizvoda usklađenim sa Stripeom radi personaliziranog sadržaja kampanja
4. Višekanalne kampanje, upotrijebite sinkronizirane podatke za ciljane kampanje e-pošte, SMS-a i WhatsAppa
5. Uvidi na nadzornoj ploči, pregledavajte Brevo metrike angažiranosti izravno u prikazu kupca u Stripe Dashboardu

Podaci o cijeni

Jasno iskomunicirajte svoj model naplate:

• Besplatno: instalacija i upotreba bez troška
• Plaćeno: navedite cijenu i učestalost naplate
• Freemium: opišite što je uključeno besplatno, a što se plaća
• Prema upotrebi: objasnite cjenovne razrede ili cijenu po jedinici

Testiranje vaše aplikacije

Prije predaje temeljito testirajte svoju aplikaciju:

Testiranje u sandbox načinu rada

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

# Verify sandbox compatibility
stripe apps validate

Format testnih pristupnih podataka

Kada timu za pregled dostavljate testne pristupne podatke, upotrijebite 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

Kontrolni popis za pregled

Prije predaje provjerite sljedeće:

• Aplikacija radi i u načinu rada uživo i u testnom načinu
• Sva dopuštenja imaju jasne opise svrhe
• Stanja pogreške obrađuju se elegantno
• Stanja učitavanja prikazuju se za asinkrone operacije
• U produkcijskoj verziji nema tvrdo kodiranih testnih podataka
• URL pravila privatnosti dostupan je i točan
• Kontaktni podaci za podršku valjani su
• Sve slike u oglasu ispunjavaju zahtjeve dimenzija
• Opis aplikacije točno odražava njezinu funkcionalnost

Nakon predaje

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

• Odobriti vašu aplikaciju za objavu
• Zatražiti izmjene uz konkretne povratne informacije
• Odbiti aplikaciju ako ne ispunjava zahtjeve

Ako su zatražene izmjene, riješite sve povratne informacije i ponovno predajte aplikaciju. Svaka ponovna predaja prolazi puni ciklus pregleda.

Ažuriranje objavljene aplikacije

Za ažuriranje već objavljene aplikacije:

1. Povećajte verziju u datoteci stripe-app.json
2. Prenesite novu verziju: stripe apps upload
3. Predajte ažuriranje na pregled
4. Nakon odobrenja ažuriranje se automatski isporučuje svim korisnicima