Vodič za integraciju Stripe Apps

Stripe Apps omogućuju vam da ugradite prilagođene funkcionalnosti izravno u Stripe Dashboard. Ovaj je odjeljak vodič za izradu: opisuje kako bi se takva aplikacija za integraciju Tajo–Brevo izradila, testirala i objavila.

Što su Stripe Apps?

Stripe Apps proširuju Stripe Dashboard prilagođenim komponentama sučelja i pozadinskim integracijama. Programerima trećih strana omogućuju sljedeće:

• Dodavanje prilagođenih prikaza na stranice Stripe Dashboarda (kupci, plaćanja, računi i slično)
• Pristup Stripe podacima putem opsegom ograničenih dopuštenja
• Sinkronizaciju podataka između Stripea i vanjskih platformi poput Breva
• Pružanje tijekova uvođenja i konfiguracije unutar Dashboarda

Ciljevi integracije Tajo + Brevo

Tajo Stripe aplikacija povezuje Stripe s Brevom kako bi isporučila sljedeće:

• Uvid u kupce: sinkronizacija Stripe profila kupaca, povijesti plaćanja i životne vrijednosti u Brevo kontakte
• Praćenje događaja: slanje Stripe događaja (plaćanja, pretplate, povrati) kao Brevo transakcijskih događaja
• Automatizirane kampanje: pokretanje Brevo kampanja e-pošte, SMS-a i WhatsAppa na temelju aktivnosti u Stripeu
• Programi vjernosti: izgradnja tijekova zadržavanja kupaca pomoću Stripe podataka o kupnji sinkroniziranih u Brevo

Pregled arhitekture

Sadržaj vodiča

Ova dokumentacija pokriva cijeli životni ciklus izrade i objave Stripe aplikacije:

Početak rada

Konfiguracija i referenca

Značajke i integracija

Rad i rast

Preduvjeti

Prije izrade Stripe aplikacije provjerite imate li sljedeće:

1. Stripe račun: aktivirani Stripe račun (nije ograničen na testni način rada)
2. Stripe CLI: instalirajte Stripe CLI za lokalni razvoj i prijenos aplikacija
3. Node.js: verzija 16 ili novija za proširenje sučelja aplikacije
4. Pristup platformi Tajo: aktivan Tajo račun s konfiguriranim vjerodajnicama Brevo API-ja

Brzi početak

# Install Stripe CLI
brew install stripe/stripe-cli/stripe

# Login to your Stripe account
stripe login

# Create a new Stripe App project
stripe apps create tajo-brevo-integration

# Start local development
stripe apps start

Ključni pojmovi

Manifest aplikacije

Svaka Stripe aplikacija ima manifest stripe-app.json koji deklarira dopuštenja, viewporte i konfiguraciju. Cjelovitu shemu potražite u referenci manifesta aplikacije.

Proširenja sučelja

Stripe aplikacije mogu prikazivati komponente sučelja temeljene na Reactu u određenim viewportima Dashboarda. Alat za izradu sučelja nudi gotove komponente usklađene s dizajnerskim sustavom Stripe Dashboarda.

Dopuštenja

Aplikacije moraju deklarirati konkretne resurse Stripe API-ja kojima trebaju pristup. Korisnici ta dopuštenja odobravaju tijekom instalacije. Pogledajte referencu dopuštenja.

Tajna za potpisivanje

Svaka aplikacija dobiva tajnu za potpisivanje kojom se provjeravaju potpisi instalacije i osigurava komunikacija između vašeg poslužiteljskog dijela i Stripea.

Tijek rada u razvoju

1. Definirajte svoj manifest s potrebnim dopuštenjima i viewportima
2. Izradite proširenje sučelja pomoću Stripeove biblioteke React komponenti
3. Implementirajte poslužiteljske krajnje točke za sinkronizaciju podataka s Brevom putem Taja
4. Testirajte lokalno pomoću stripe apps start
5. Prenesite naredbom stripe apps upload
6. Predajte na pregled putem Stripe Dashboarda
7. Objavite i pratite rad putem analitike

Sljedeći koraci

Započnite s vodičem za objavu kako biste razumjeli sve zahtjeve, a zatim prođite kroz tehničke reference da biste konfigurirali manifest i dopuštenja svoje aplikacije.