Objava v tržnici Stripe App Marketplace

Z objavo aplikacije Stripe App v tržnici postane ta na voljo vsem uporabnikom platforme Stripe. Ta vodnik zajema zahteve, korake priprave in postopek oddaje.

Predpogoji

Preden lahko objavite aplikacijo v tržnici Stripe App Marketplace, morate izpolniti te zahteve:

• Aktiviran račun Stripe: vaš račun ne sme biti omejen samo na testni način
• Ena aplikacija na račun: vsak račun Stripe lahko v tržnici objavi samo eno javno aplikacijo
• Samo v angleščini: vsa vsebina aplikacije, besedilo vmesnika in podatki v opisu morajo biti v angleščini
• Dokončana aplikacija: vaša aplikacija mora biti povsem delujoča in preizkušena

Koraki objave

1. korak: Posodobite svoj manifest

V datoteki stripe-app.json nastavite distribution_type 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"
    }
  ]
}

2. korak: Pripravite svojo aplikacijo

Pred oddajo poskrbite, da vaša aplikacija izpolnjuje vse zahteve za pregled:

1. Temeljito jo preizkusite v načinu v živo in v peskovniku
2. Preverite, ali so vsa dovoljenja nujna in dokumentirana
3. Potrdite, da sta obravnava napak in prikaz stanj nalaganja izvedena
4. Preverite, ali je vse besedilo vmesnika v angleščini

3. korak: Naložite svojo aplikacijo

Za nalaganje aplikacije uporabite Stripe CLI:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

4. korak: Napišite svoj opis

Za dokončanje opisa aplikacije odprite nadzorno ploščo Stripe. Za oddajo v tržnico so obvezna vsa polja opisa.

5. korak: Oddajte v pregled

Ko dokončate opis, oddajte aplikacijo v pregled prek nadzorne plošče Stripe. Ekipa Stripe bo vašo aplikacijo ocenila glede na zahteve glede kakovosti.

6. korak: Objavite

Ko je aplikacija odobrena, jo lahko objavite in s tem omogočite v tržnici.

Nastavitev manifesta za javno distribucijo

Manifest mora vsebovati distribution_type: "public" in navesti vsa zahtevana dovoljenja z jasnimi opisi namena:

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

Nastavljeno aplikacijo naložite z:

stripe apps upload

Zahteve za opis

Opis vaše aplikacije mora vsebovati vsa naslednja polja:

Smernice za ime

• Mora biti edinstveno v tržnici
• Jasno naj pove, čemu je aplikacija namenjena
• Izogibajte se splošnim izrazom, ki bi lahko zmedli uporabnike
• Primer: „Tajo for Brevo“ (15 znakov)

Smernice za ikono

• Mere: točno 300 x 300 slikovnih pik
• Oblika zapisa: PNG ali SVG
• Ne dodajajte zaobljenih vogalov, Stripe jih doda samodejno
• Uporabite jasen, prepoznaven logotip ali simbol
• Poskrbite za berljivost pri majhnih velikostih

Razdelek „O aplikaciji“

Napišite prepričljiv opis, ki zajema:

• Katero težavo rešuje vaša aplikacija
• Ključne zmožnosti integracije
• Komu je aplikacija namenjena
• Morebitne predpogoje ali zahteve

Primer:

Tajo for Brevo poveže vaše plačilne podatke iz platforme Stripe s platformo za avtomatizacijo trženja Brevo. Samodejno sinhronizirajte stranke, sledite plačilnim dogodkom in sprožajte prilagojene kampanje po e-pošti, SMS in WhatsApp na podlagi nakupnega vedenja v realnem času. Zasnovano za podjetja v e-trgovini, ki želijo s trženjem za zadrževanje strank, podprtim s podatki, čim bolj povečati življenjsko vrednost stranke.

Ključne funkcije

Vsak vnos ključne funkcije vsebuje:

• Naslov: kratko ime funkcije
• Opis: en do dva stavka, ki pojasnita funkcijo
• Slika: posnetek zaslona ali diagram (priporočeno 1600 x 900 slikovnih pik)

Priporočene funkcije za integracijo Tajo Brevo:

1. Sinhronizacija strank v realnem času, samodejno sinhronizirajte profile strank Stripe s stiki Brevo skupaj s celotno zgodovino nakupov
2. Avtomatizacija na podlagi dogodkov, sprožajte poteke dela Brevo iz dogodkov Stripe, kot so uspešna plačila, spremembe naročnin in vračila
3. Sinhronizacija kataloga izdelkov, ohranjajte svoj katalog izdelkov Brevo usklajen s platformo Stripe za prilagojeno vsebino kampanj
4. Večkanalne kampanje, uporabite sinhronizirane podatke za ciljane kampanje po e-pošti, SMS in WhatsApp
5. Vpogledi v nadzorni plošči, oglejte si meritve sodelovanja iz platforme Brevo neposredno v pogledu stranke v nadzorni plošči Stripe

Podatki o cenah

Jasno sporočite svoj cenovni model:

• Brezplačno: namestitev in uporaba brez stroškov
• Plačljivo: navedite ceno in pogostost obračunavanja
• Freemium: opišite, kaj je vključeno brezplačno in kaj je plačljivo
• Glede na porabo: pojasnite cenovne stopnje ali stroške na enoto

Preizkušanje vaše aplikacije

Pred oddajo temeljito preizkusite svojo aplikacijo:

Preizkus v peskovniku

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

# Verify sandbox compatibility
stripe apps validate

Oblika testnih poverilnic

Ko ekipi za pregled posredujete testne poverilnice, uporabite to obliko:

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 seznam za pregled

Pred oddajo preverite:

• Aplikacija deluje v načinu v živo in v testnem načinu
• Vsa dovoljenja imajo jasne opise namena
• Stanja napak so obravnavana brez zapletov
• Za asinhrone operacije so prikazana stanja nalaganja
• V produkcijski gradnji ni trdo zakodiranih testnih podatkov
• URL pravilnika o zasebnosti je dostopen in točen
• Podatki za stik s podporo so veljavni
• Vse slike v opisu ustrezajo zahtevam glede mer
• Opis aplikacije natančno odraža njeno delovanje

Po oddaji

Ekipa za pregled pri Stripe se običajno odzove v 5-10 delovnih dneh. Lahko:

• odobri vašo aplikacijo za objavo,
• zahteva spremembe s konkretnimi povratnimi informacijami,
• zavrne aplikacijo, če ne izpolnjuje zahtev.

Če so zahtevane spremembe, upoštevajte vse povratne informacije in aplikacijo oddajte znova. Vsaka ponovna oddaja gre skozi celoten cikel pregleda.

Posodabljanje objavljene aplikacije

Za posodobitev že objavljene aplikacije:

1. Povečajte različico v datoteki stripe-app.json
2. Naložite novo različico: stripe apps upload
3. Oddajte posodobitev v pregled
4. Po odobritvi se posodobitev samodejno uvede pri vseh uporabnikih