Bed om tidlig adgang til Tajo

Indtast dit fornavn og din arbejds-e-mailadresse. Vi sender dig et link til at bekræfte din anmodning om adgang til Tajo.

På denne side

Tilladelsesreference

Stripe Apps bruger et tilladelsessystem til at styre adgangen til ressourcer i Stripe API. Hver tilladelse skal deklareres udtrykkeligt i dit app-manifest med en klar formålserklæring. Brugerne godkender disse tilladelser, når de installerer din app.

Caution

Status: planlagt. Der findes endnu ingen Tajo-app i Stripe App Marketplace. App-ID’er, URL’er og loginoplysninger på denne side er illustrative pladsholdere, ikke aktive endpoints.

Håndtering af tilladelser

Deklarering af tilladelser

Tilføj tilladelser til dit stripe-app.json-manifest:

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

Tildeling af tilladelser via CLI

Under udvikling kan du tildele tilladelser 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"

Bedste praksis for tilladelser

Færrest mulige: Bed kun om de tilladelser, din app faktisk bruger
Klare formål: Skriv formålserklæringer, som ikke-tekniske brugere kan forstå
Begrund læse plus skrive: Har du brug for begge, så forklar hvorfor i hvert formål
Gennemgå jævnligt: Fjern tilladelser, der ikke længere er nødvendige, når du opdaterer din app

Tip

At bede om for mange tilladelser er en af de hyppigste årsager til, at en app bliver afvist. Bed kun om det, du har brug for.

Tilladelser pr. produkt

Kerne

Ressource	Tilladelse	Beskrivelse
Konto	`account_read`	Læs kontooplysninger og indstillinger
Konto	`account_write`	Opdater kontoindstillinger
Saldo	`balance_read`	Se kontosaldo og transaktioner
Kunde	`customer_read`	Læs kundeprofiler, metadata og betalingsmetoder
Kunde	`customer_write`	Opret, opdater eller slet kundeposter
Hændelse	`event_read`	Læs og abonner på kontohændelser
Fil	`file_read`	Læs uploadede filer og fillinks
Fil	`file_write`	Upload filer og opret fillinks
Mandat	`mandate_read`	Læs betalingsmandater
Produkt	`product_read`	Læs produktkatalog og priser
Produkt	`product_write`	Opret, opdater eller slet produkter og priser
Token	`token_read`	Læs tokeniserede betalingsdata
Webhook-endpoint	`webhook_endpoint_read`	Læs konfigurationer af webhook-endpoints
Webhook-endpoint	`webhook_endpoint_write`	Opret, opdater eller slet webhook-endpoints

Betalinger

Ressource	Tilladelse	Beskrivelse
Opkrævning	`charge_read`	Læs betalingsopkrævninger og refusioner
Opkrævning	`charge_write`	Opret opkrævninger, hæv betalinger, udsted refusioner
Tvist	`dispute_read`	Læs betalingstvister og beviser
Tvist	`dispute_write`	Indsend beviser og svar på tvister
Payment Intent	`payment_intent_read`	Læs oplysninger og status for payment intents
Payment Intent	`payment_intent_write`	Opret, bekræft eller annuller payment intents
Betalingsmetode	`payment_method_read`	Læs gemte betalingsmetoder
Betalingsmetode	`payment_method_write`	Tilknyt eller fjern betalingsmetoder fra kunder
Udbetaling	`payout_read`	Læs oplysninger og planer for udbetalinger
Udbetaling	`payout_write`	Opret eller annuller udbetalinger
Refusion	`refund_read`	Læs oplysninger om refusioner
Refusion	`refund_write`	Opret eller opdater refusioner
Setup Intent	`setup_intent_read`	Læs oplysninger om setup intents
Setup Intent	`setup_intent_write`	Opret eller bekræft setup intents

Fakturering

Ressource	Tilladelse	Beskrivelse
Kupon	`coupon_read`	Læs rabatkuponer og kampagnekoder
Kupon	`coupon_write`	Opret, opdater eller slet kuponer
Kreditnota	`credit_note_read`	Læs kreditnotaer
Kreditnota	`credit_note_write`	Opret eller annuller kreditnotaer
Faktura	`invoice_read`	Læs fakturaoplysninger, linjer og status
Faktura	`invoice_write`	Opret, opdater, færdiggør eller annuller fakturaer
Fakturalinje	`invoice_item_read`	Læs afventende fakturalinjer
Fakturalinje	`invoice_item_write`	Opret eller slet fakturalinjer
Plan	`plan_read`	Læs abonnementsplaner og priser
Plan	`plan_write`	Opret, opdater eller slet planer
Pris	`price_read`	Læs priskonfigurationer
Pris	`price_write`	Opret eller opdater priser
Tilbud	`quote_read`	Læs pristilbud
Tilbud	`quote_write`	Opret, færdiggør eller accepter tilbud
Abonnement	`subscription_read`	Læs abonnementsoplysninger, planer og status
Abonnement	`subscription_write`	Opret, opdater eller opsig abonnementer
Abonnementsplan	`subscription_schedule_read`	Læs abonnementsplaner
Abonnementsplan	`subscription_schedule_write`	Opret, opdater eller frigiv abonnementsplaner
Forbrugspost	`usage_record_read`	Læs forbrugsposter til forbrugsafregning
Forbrugspost	`usage_record_write`	Opret forbrugsposter til forbrugsafregning

Checkout

Ressource	Tilladelse	Beskrivelse
Checkout Session	`checkout_session_read`	Læs oplysninger og linjer for Checkout Sessions
Checkout Session	`checkout_session_write`	Opret eller udløb Checkout Sessions
Payment Link	`payment_link_read`	Læs konfigurationer af Payment Links
Payment Link	`payment_link_write`	Opret eller opdater Payment Links

Connect

Ressource	Tilladelse	Beskrivelse
Applikationsgebyr	`application_fee_read`	Læs oplysninger om applikationsgebyrer
Tilknyttet konto	`connected_account_read`	Læs oplysninger om tilknyttede konti
Tilknyttet konto	`connected_account_write`	Opret eller opdater tilknyttede konti
Overførsel	`transfer_read`	Læs oplysninger om overførsler mellem konti
Overførsel	`transfer_write`	Opret overførsler til tilknyttede konti
Top-up	`topup_read`	Læs oplysninger om top-ups
Top-up	`topup_write`	Opret top-ups til Stripe-saldoen

Issuing

Ressource	Tilladelse	Beskrivelse
Issuing-kort	`issuing_card_read`	Læs oplysninger om udstedte kort
Issuing-kort	`issuing_card_write`	Opret, opdater eller deaktiver udstedte kort
Issuing-kortholder	`issuing_cardholder_read`	Læs oplysninger om kortholdere
Issuing-kortholder	`issuing_cardholder_write`	Opret eller opdater kortholdere
Issuing-transaktion	`issuing_transaction_read`	Læs oplysninger om korttransaktioner
Issuing-autorisation	`issuing_authorization_read`	Læs autorisationsanmodninger
Issuing-autorisation	`issuing_authorization_write`	Godkend eller afvis autorisationsanmodninger
Issuing-tvist	`issuing_dispute_read`	Læs issuing-tvister
Issuing-tvist	`issuing_dispute_write`	Opret eller indsend issuing-tvister

Rapportering

Ressource	Tilladelse	Beskrivelse
Rapportkørsel	`report_run_read`	Læs resultater af rapportkørsler
Rapportkørsel	`report_run_write`	Opret nye rapportkørsler
Rapporttype	`report_type_read`	Læs tilgængelige rapporttyper

Skat

Ressource	Tilladelse	Beskrivelse
Skatteberegning	`tax_calculation_read`	Læs resultater af skatteberegninger
Skatteberegning	`tax_calculation_write`	Opret skatteberegninger
Skattesats	`tax_rate_read`	Læs konfigurationer af skattesatser
Skattesats	`tax_rate_write`	Opret eller opdater skattesatser
Skatteregistrering	`tax_registration_read`	Læs oplysninger om skatteregistrering

Terminal

Ressource	Tilladelse	Beskrivelse
Terminallæser	`terminal_reader_read`	Læs oplysninger om terminallæsere
Terminallæser	`terminal_reader_write`	Registrer eller opdater terminallæsere
Terminalplacering	`terminal_location_read`	Læs oplysninger om terminalplaceringer
Terminalplacering	`terminal_location_write`	Opret eller opdater terminalplaceringer

Secret Store

Ressource	Tilladelse	Beskrivelse
Hemmelighed	`secret_read`	Læs hemmeligheder fra Secret Store
Hemmelighed	`secret_write`	Opret, opdater eller slet hemmeligheder

Anbefalede tilladelser til Tajos Brevo-integration

Til Tajos Brevo-integrationsapp er disse tilladelser de anbefalede:

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

Tilladelsernes omfang

Tilladelser kan gælde på forskellige niveauer, alt efter om din app er installeret på en platformskonto eller en tilknyttet konto:

Omfang	Beskrivelse
Konto	Tilladelserne gælder den installerende kontos egne data
Tilknyttet konto	For Connect-platforme kan tilladelserne udvides til tilknyttede konti