Be om tidlig tilgang

Skriv inn fornavn og e-postadresse på jobb. Vi sender deg en lenke for å bekrefte forespørselen om tilgang til Tajo.

På denne siden

Tillatelsesreferanse

Stripe Apps bruker et tillatelsessystem for å styre tilgangen til ressurser i Stripe API. Hver tillatelse må erklæres eksplisitt i app-manifestet ditt, med en tydelig beskrivelse av formålet. Brukerne godkjenner disse tillatelsene når de installerer appen din.

Caution

Status: planlagt. Det finnes ennå ingen Tajo-app i Stripe App Marketplace. App-identifikatorene, URL-ene og legitimasjonen på denne siden er illustrerende plassholdere, ikke ekte endepunkter.

Administrere tillatelser

Erklære tillatelser

Legg tillatelsene inn i stripe-app.json-manifestet ditt:

{
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Read customer profiles to sync with Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Update customer metadata with Brevo sync status"
    }
  ]
}

Gi tillatelser via CLI

Under utvikling kan du gi tillatelser med Stripe CLI:

# Grant a specific permission
stripe apps grant permission "customer_read" \
  --purpose "Read customer profiles to sync with Brevo contacts"

# Grant multiple permissions
stripe 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"

Beste praksis for tillatelser

Minst mulig: Be bare om tillatelser appen din faktisk bruker
Tydelige formål: Skriv formålsbeskrivelser som ikke-tekniske brukere forstår
Begrunn både lesing og skriving: Trenger du begge deler, forklar hvorfor i hvert enkelt formål
Gå gjennom jevnlig: Fjern tillatelser du ikke lenger trenger når du oppdaterer appen

Tip

Å be om for mange tillatelser er en av de vanligste grunnene til at apper blir avvist. Be bare om det du trenger.

Tillatelser per produkt

Kjerne

Ressurs	Tillatelse	Beskrivelse
Konto	`account_read`	Les kontodetaljer og innstillinger
Konto	`account_write`	Oppdater kontoinnstillinger
Saldo	`balance_read`	Se kontosaldo og transaksjoner
Kunde	`customer_read`	Les kundeprofiler, metadata og betalingsmåter
Kunde	`customer_write`	Opprett, oppdater eller slett kundeoppføringer
Hendelse	`event_read`	Les og abonner på hendelser på kontoen
Fil	`file_read`	Les opplastede filer og fillenker
Fil	`file_write`	Last opp filer og opprett fillenker
Mandat	`mandate_read`	Les betalingsmandater
Produkt	`product_read`	Les produktkatalog og priser
Produkt	`product_write`	Opprett, oppdater eller slett produkter og priser
Token	`token_read`	Les tokeniserte betalingsdata
Webhook-endepunkt	`webhook_endpoint_read`	Les konfigurasjoner for webhook-endepunkter
Webhook-endepunkt	`webhook_endpoint_write`	Opprett, oppdater eller slett webhook-endepunkter

Betalinger

Ressurs	Tillatelse	Beskrivelse
Belastning	`charge_read`	Les belastninger og refusjoner
Belastning	`charge_write`	Opprett belastninger, trekk betalinger og gi refusjoner
Innsigelse	`dispute_read`	Les innsigelser på betalinger og tilhørende bevis
Innsigelse	`dispute_write`	Send inn bevis og svar på innsigelser
Payment Intent	`payment_intent_read`	Les detaljer og status for payment intents
Payment Intent	`payment_intent_write`	Opprett, bekreft eller avbryt payment intents
Betalingsmåte	`payment_method_read`	Les lagrede betalingsmåter
Betalingsmåte	`payment_method_write`	Knytt betalingsmåter til eller fra kunder
Utbetaling	`payout_read`	Les detaljer og planer for utbetalinger
Utbetaling	`payout_write`	Opprett eller avbryt utbetalinger
Refusjon	`refund_read`	Les detaljer om refusjoner
Refusjon	`refund_write`	Opprett eller oppdater refusjoner
Setup Intent	`setup_intent_read`	Les detaljer om setup intents
Setup Intent	`setup_intent_write`	Opprett eller bekreft setup intents

Fakturering

Ressurs	Tillatelse	Beskrivelse
Rabattkupong	`coupon_read`	Les rabattkuponger og kampanjekoder
Rabattkupong	`coupon_write`	Opprett, oppdater eller slett kuponger
Kreditnota	`credit_note_read`	Les kreditnotaer
Kreditnota	`credit_note_write`	Opprett eller annuller kreditnotaer
Faktura	`invoice_read`	Les fakturadetaljer, fakturalinjer og status
Faktura	`invoice_write`	Opprett, oppdater, ferdigstill eller annuller fakturaer
Fakturalinje	`invoice_item_read`	Les ventende fakturalinjer
Fakturalinje	`invoice_item_write`	Opprett eller slett fakturalinjer
Plan	`plan_read`	Les abonnementsplaner og priser
Plan	`plan_write`	Opprett, oppdater eller slett planer
Pris	`price_read`	Les priskonfigurasjoner
Pris	`price_write`	Opprett eller oppdater priser
Tilbud	`quote_read`	Les pristilbud
Tilbud	`quote_write`	Opprett, ferdigstill eller godta tilbud
Abonnement	`subscription_read`	Les abonnementsdetaljer, planer og status
Abonnement	`subscription_write`	Opprett, oppdater eller si opp abonnementer
Abonnementsplan	`subscription_schedule_read`	Les abonnementsplaner
Abonnementsplan	`subscription_schedule_write`	Opprett, oppdater eller frigi abonnementsplaner
Forbruksoppføring	`usage_record_read`	Les forbruksoppføringer for forbruksbasert fakturering
Forbruksoppføring	`usage_record_write`	Opprett forbruksoppføringer for forbruksbasert fakturering

Checkout

Ressurs	Tillatelse	Beskrivelse
Checkout Session	`checkout_session_read`	Les detaljer og linjer i Checkout Session
Checkout Session	`checkout_session_write`	Opprett eller avslutt Checkout Sessions
Payment Link	`payment_link_read`	Les konfigurasjonen av Payment Links
Payment Link	`payment_link_write`	Opprett eller oppdater Payment Links

Connect

Ressurs	Tillatelse	Beskrivelse
Applikasjonsgebyr	`application_fee_read`	Les detaljer om applikasjonsgebyrer
Tilkoblet konto	`connected_account_read`	Les detaljer om tilkoblede kontoer
Tilkoblet konto	`connected_account_write`	Opprett eller oppdater tilkoblede kontoer
Overføring	`transfer_read`	Les detaljer om overføringer mellom kontoer
Overføring	`transfer_write`	Opprett overføringer til tilkoblede kontoer
Påfylling	`topup_read`	Les detaljer om påfyllinger
Påfylling	`topup_write`	Opprett påfyllinger av Stripe-saldoen

Issuing

Ressurs	Tillatelse	Beskrivelse
Utstedt kort	`issuing_card_read`	Les detaljer om utstedte kort
Utstedt kort	`issuing_card_write`	Opprett, oppdater eller deaktiver utstedte kort
Kortholder	`issuing_cardholder_read`	Les informasjon om kortholdere
Kortholder	`issuing_cardholder_write`	Opprett eller oppdater kortholdere
Korttransaksjon	`issuing_transaction_read`	Les detaljer om korttransaksjoner
Autorisasjon	`issuing_authorization_read`	Les autorisasjonsforespørsler
Autorisasjon	`issuing_authorization_write`	Godkjenn eller avslå autorisasjonsforespørsler
Innsigelse på utstedt kort	`issuing_dispute_read`	Les innsigelser knyttet til utstedte kort
Innsigelse på utstedt kort	`issuing_dispute_write`	Opprett eller send inn innsigelser på utstedte kort

Rapportering

Ressurs	Tillatelse	Beskrivelse
Rapportkjøring	`report_run_read`	Les resultatene av rapportkjøringer
Rapportkjøring	`report_run_write`	Opprett nye rapportkjøringer
Rapporttype	`report_type_read`	Les tilgjengelige rapporttyper

Skatt

Ressurs	Tillatelse	Beskrivelse
Skatteberegning	`tax_calculation_read`	Les resultatene av skatteberegninger
Skatteberegning	`tax_calculation_write`	Opprett skatteberegninger
Skattesats	`tax_rate_read`	Les konfigurasjonen av skattesatser
Skattesats	`tax_rate_write`	Opprett eller oppdater skattesatser
Skatteregistrering	`tax_registration_read`	Les detaljer om skatteregistreringer

Terminal

Ressurs	Tillatelse	Beskrivelse
Terminalleser	`terminal_reader_read`	Les detaljer om terminallesere
Terminalleser	`terminal_reader_write`	Registrer eller oppdater terminallesere
Terminallokasjon	`terminal_location_read`	Les detaljer om terminallokasjoner
Terminallokasjon	`terminal_location_write`	Opprett eller oppdater terminallokasjoner

Secret Store

Ressurs	Tillatelse	Beskrivelse
Hemmelighet	`secret_read`	Les hemmeligheter fra Secret Store
Hemmelighet	`secret_write`	Opprett, oppdater eller slett hemmeligheter

Anbefalte tillatelser for Tajo Brevo-integrasjonen

For Tajo Brevo-integrasjonsappen er dette de anbefalte tillatelsene:

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

Omfang for tillatelser

Tillatelser kan gjelde ulike omfang, avhengig av om appen din er installert på en plattformkonto eller på en tilkoblet konto:

Omfang	Beskrivelse
Konto	Tillatelsene gjelder dataene til kontoen som installerer appen
Tilkoblet konto	For Connect-plattformer kan tillatelsene også omfatte tilkoblede kontoer