Referenca dopuštenja
Stripe aplikacije koriste sustav dopuštenja za upravljanje pristupom resursima Stripe API-ja. Svako dopuštenje mora biti izričito navedeno u manifestu aplikacije uz jasnu izjavu o svrsi. Korisnici odobravaju ta dopuštenja kada instaliraju vašu aplikaciju.
Caution
Status: planirano. U tržnici Stripe App Marketplace još nema Tajo aplikacije. Identifikatori aplikacije, URL-ovi i vjerodajnice na ovoj stranici ilustrativni su rezervirani unosi, a ne stvarne krajnje točke.
Upravljanje dopuštenjima
Navođenje dopuštenja
Dodajte dopuštenja u svoj manifest stripe-app.json:
{ "permissions": [ { "permission": "customer_read", "purpose": "Read customer profiles to sync with Brevo contacts" }, { "permission": "customer_write", "purpose": "Update customer metadata with Brevo sync status" } ]}Dodjela dopuštenja putem CLI-ja
Tijekom razvoja dopuštenja možete dodijeliti pomoću Stripe CLI-ja:
# Grant a specific permissionstripe apps grant permission "customer_read" \ --purpose "Read customer profiles to sync with Brevo contacts"
# Grant multiple permissionsstripe apps grant permission "charge_read" \ --purpose "Access payment data for event tracking"
stripe apps grant permission "event_read" \ --purpose "Subscribe to real-time Stripe events"Najbolje prakse za dopuštenja
- Najmanji nužni opseg: tražite samo dopuštenja koja vaša aplikacija stvarno koristi
- Jasne svrhe: pišite izjave o svrsi koje mogu razumjeti i netehnički korisnici
- Obrazložite čitanje i pisanje: ako trebate i čitanje i pisanje, objasnite zašto u svakoj svrsi
- Redovito preispitujte: pri ažuriranju aplikacije uklonite dopuštenja koja više nisu potrebna
Tip
Traženje prekomjernih dopuštenja jedan je od najčešćih razloga za odbijanje aplikacije. Tražite samo ono što vam je potrebno.
Dopuštenja po proizvodu
Osnovno
| Resurs | Dopuštenje | Opis |
|---|---|---|
| Account | account_read | Čitanje pojedinosti i postavki računa |
| Account | account_write | Ažuriranje postavki računa |
| Balance | balance_read | Pregled stanja računa i transakcija |
| Customer | customer_read | Čitanje profila kupaca, metapodataka i načina plaćanja |
| Customer | customer_write | Stvaranje, ažuriranje ili brisanje zapisa o kupcima |
| Event | event_read | Čitanje događaja na računu i pretplata na njih |
| File | file_read | Čitanje prenesenih datoteka i poveznica na datoteke |
| File | file_write | Prijenos datoteka i stvaranje poveznica na datoteke |
| Mandate | mandate_read | Čitanje platnih mandata |
| Product | product_read | Čitanje kataloga proizvoda i cijena |
| Product | product_write | Stvaranje, ažuriranje ili brisanje proizvoda i cijena |
| Token | token_read | Čitanje tokeniziranih platnih podataka |
| Webhook Endpoint | webhook_endpoint_read | Čitanje konfiguracija krajnjih točaka za webhookove |
| Webhook Endpoint | webhook_endpoint_write | Stvaranje, ažuriranje ili brisanje krajnjih točaka za webhookove |
Plaćanja
| Resurs | Dopuštenje | Opis |
|---|---|---|
| Charge | charge_read | Čitanje naplata i povrata sredstava |
| Charge | charge_write | Stvaranje naplata, zaprimanje plaćanja, izdavanje povrata |
| Dispute | dispute_read | Čitanje sporova o plaćanju i dokaza |
| Dispute | dispute_write | Slanje dokaza i odgovaranje na sporove |
| Payment Intent | payment_intent_read | Čitanje pojedinosti i statusa namjere plaćanja |
| Payment Intent | payment_intent_write | Stvaranje, potvrda ili otkazivanje namjera plaćanja |
| Payment Method | payment_method_read | Čitanje spremljenih načina plaćanja |
| Payment Method | payment_method_write | Povezivanje ili odvajanje načina plaćanja od kupaca |
| Payout | payout_read | Čitanje pojedinosti i rasporeda isplata |
| Payout | payout_write | Stvaranje ili otkazivanje isplata |
| Refund | refund_read | Čitanje pojedinosti o povratima sredstava |
| Refund | refund_write | Stvaranje ili ažuriranje povrata sredstava |
| Setup Intent | setup_intent_read | Čitanje pojedinosti namjere postavljanja |
| Setup Intent | setup_intent_write | Stvaranje ili potvrda namjera postavljanja |
Naplata
| Resurs | Dopuštenje | Opis |
|---|---|---|
| Coupon | coupon_read | Čitanje kupona za popust i promotivnih kodova |
| Coupon | coupon_write | Stvaranje, ažuriranje ili brisanje kupona |
| Credit Note | credit_note_read | Čitanje odobrenja |
| Credit Note | credit_note_write | Stvaranje ili poništavanje odobrenja |
| Invoice | invoice_read | Čitanje pojedinosti računa, stavaka i statusa |
| Invoice | invoice_write | Stvaranje, ažuriranje, finaliziranje ili poništavanje računa |
| Invoice Item | invoice_item_read | Čitanje stavaka računa na čekanju |
| Invoice Item | invoice_item_write | Stvaranje ili brisanje stavaka računa |
| Plan | plan_read | Čitanje pretplatničkih planova i cijena |
| Plan | plan_write | Stvaranje, ažuriranje ili brisanje planova |
| Price | price_read | Čitanje konfiguracija cijena |
| Price | price_write | Stvaranje ili ažuriranje cijena |
| Quote | quote_read | Čitanje ponuda s cijenama |
| Quote | quote_write | Stvaranje, finaliziranje ili prihvaćanje ponuda |
| Subscription | subscription_read | Čitanje pojedinosti, rasporeda i statusa pretplata |
| Subscription | subscription_write | Stvaranje, ažuriranje ili otkazivanje pretplata |
| Subscription Schedule | subscription_schedule_read | Čitanje rasporeda pretplata |
| Subscription Schedule | subscription_schedule_write | Stvaranje, ažuriranje ili otpuštanje rasporeda pretplata |
| Usage Record | usage_record_read | Čitanje zapisa o potrošnji za naplatu po potrošnji |
| Usage Record | usage_record_write | Stvaranje zapisa o potrošnji za naplatu po potrošnji |
Plaćanje (Checkout)
| Resurs | Dopuštenje | Opis |
|---|---|---|
| Checkout Session | checkout_session_read | Čitanje pojedinosti i stavaka Checkout Sessiona |
| Checkout Session | checkout_session_write | Stvaranje ili isticanje Checkout Sessiona |
| Payment Link | payment_link_read | Čitanje konfiguracija Payment Linkova |
| Payment Link | payment_link_write | Stvaranje ili ažuriranje Payment Linkova |
Connect
| Resurs | Dopuštenje | Opis |
|---|---|---|
| Application Fee | application_fee_read | Čitanje pojedinosti o naknadi aplikacije |
| Connected Account | connected_account_read | Čitanje pojedinosti povezanog računa |
| Connected Account | connected_account_write | Stvaranje ili ažuriranje povezanih računa |
| Transfer | transfer_read | Čitanje pojedinosti o prijenosima između računa |
| Transfer | transfer_write | Stvaranje prijenosa na povezane račune |
| Top-up | topup_read | Čitanje pojedinosti o nadopunama |
| Top-up | topup_write | Stvaranje nadopuna Stripe stanja |
Issuing
| Resurs | Dopuštenje | Opis |
|---|---|---|
| Issuing Card | issuing_card_read | Čitanje pojedinosti izdanih kartica |
| Issuing Card | issuing_card_write | Stvaranje, ažuriranje ili deaktivacija izdanih kartica |
| Issuing Cardholder | issuing_cardholder_read | Čitanje podataka o vlasnicima kartica |
| Issuing Cardholder | issuing_cardholder_write | Stvaranje ili ažuriranje vlasnika kartica |
| Issuing Transaction | issuing_transaction_read | Čitanje pojedinosti o transakcijama karticom |
| Issuing Authorization | issuing_authorization_read | Čitanje zahtjeva za autorizaciju |
| Issuing Authorization | issuing_authorization_write | Odobravanje ili odbijanje zahtjeva za autorizaciju |
| Issuing Dispute | issuing_dispute_read | Čitanje sporova povezanih s izdavanjem kartica |
| Issuing Dispute | issuing_dispute_write | Stvaranje ili podnošenje sporova povezanih s izdavanjem kartica |
Izvještavanje
| Resurs | Dopuštenje | Opis |
|---|---|---|
| Report Run | report_run_read | Čitanje rezultata pokretanja izvještaja |
| Report Run | report_run_write | Pokretanje novih izvještaja |
| Report Type | report_type_read | Čitanje dostupnih vrsta izvještaja |
Porezi
| Resurs | Dopuštenje | Opis |
|---|---|---|
| Tax Calculation | tax_calculation_read | Čitanje rezultata izračuna poreza |
| Tax Calculation | tax_calculation_write | Stvaranje izračuna poreza |
| Tax Rate | tax_rate_read | Čitanje konfiguracija poreznih stopa |
| Tax Rate | tax_rate_write | Stvaranje ili ažuriranje poreznih stopa |
| Tax Registration | tax_registration_read | Čitanje pojedinosti porezne registracije |
Terminal
| Resurs | Dopuštenje | Opis |
|---|---|---|
| Terminal Reader | terminal_reader_read | Čitanje pojedinosti o terminalskim čitačima |
| Terminal Reader | terminal_reader_write | Registracija ili ažuriranje terminalskih čitača |
| Terminal Location | terminal_location_read | Čitanje pojedinosti o lokacijama terminala |
| Terminal Location | terminal_location_write | Stvaranje ili ažuriranje lokacija terminala |
Secret Store
| Resurs | Dopuštenje | Opis |
|---|---|---|
| Secret | secret_read | Čitanje tajni iz Secret Storea |
| Secret | secret_write | Stvaranje, ažuriranje ili brisanje tajni |
Preporučena dopuštenja za Tajo Brevo integraciju
Za aplikaciju Tajo Brevo integracije preporučuju se sljedeća dopuštenja:
{ "permissions": [ { "permission": "customer_read", "purpose": "Sync customer profiles and contact information to Brevo" }, { "permission": "customer_write", "purpose": "Store Brevo contact ID and sync status on customer metadata" }, { "permission": "charge_read", "purpose": "Track purchase events and revenue data for Brevo analytics" }, { "permission": "product_read", "purpose": "Sync product catalog to Brevo for personalized email campaigns" }, { "permission": "event_read", "purpose": "Listen to real-time events to trigger Brevo automation workflows" }, { "permission": "invoice_read", "purpose": "Track invoice events for transactional emails via Brevo" }, { "permission": "subscription_read", "purpose": "Monitor subscription lifecycle for Brevo retention campaigns" }, { "permission": "secret_write", "purpose": "Securely store Brevo API credentials in Stripe Secret Store" }, { "permission": "secret_read", "purpose": "Retrieve stored Brevo API credentials for data sync operations" }, { "permission": "webhook_endpoint_write", "purpose": "Register webhook endpoints for real-time event delivery to Tajo" } ]}Opsezi dopuštenja
Dopuštenja mogu djelovati u različitim opsezima, ovisno o tome je li vaša aplikacija instalirana na platformskom računu ili na povezanom računu:
| Opseg | Opis |
|---|---|
| Račun | Dopuštenja se primjenjuju na podatke računa koji instalira aplikaciju |
| Povezani račun | Za Connect platforme dopuštenja se mogu proširiti na povezane račune |
Caution
Kada tražite dopuštenja za pisanje, pripremite se da tijekom pregleda aplikacije objasnite točno kako i kada vaša aplikacija mijenja podatke. Nepotrebna dopuštenja za pisanje čest su razlog za odbijanje.