Referință pentru permisiuni

Aplicațiile Stripe folosesc un sistem de permisiuni pentru a controla accesul la resursele API Stripe. Fiecare permisiune trebuie declarată explicit în manifestul aplicației, împreună cu o justificare clară a scopului. Utilizatorii aprobă aceste permisiuni atunci când îți instalează aplicația.

Gestionarea permisiunilor

Declararea permisiunilor

Adaugă permisiunile în manifestul 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"
    }
  ]
}

Acordarea permisiunilor din CLI

În timpul dezvoltării, poți acorda permisiuni folosind 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"

Bune practici pentru permisiuni

• Minimul necesar: cere doar permisiunile pe care aplicația ta chiar le folosește
• Scopuri clare: scrie justificări pe care le pot înțelege și utilizatorii fără cunoștințe tehnice
• Justifică citirea și scrierea: dacă ai nevoie și de citire, și de scriere, explică motivul în fiecare justificare
• Revizuiește periodic: elimină permisiunile care nu mai sunt necesare atunci când îți actualizezi aplicația

Permisiuni pe produs

Core

Payments

Billing

Checkout

Connect

Issuing

Reporting

Tax

Terminal

Secret Store

Permisiuni recomandate pentru integrarea Tajo cu Brevo

Pentru aplicația de integrare Tajo cu Brevo, acestea sunt permisiunile recomandate:

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

Domeniile de aplicare a permisiunilor

Permisiunile pot funcționa la niveluri diferite, în funcție de instalarea aplicației pe un cont de platformă sau pe un cont conectat: