On this page

Справочник за разрешения

Stripe Apps използват система от разрешения за контрол на достъпа до ресурсите на Stripe API. Всяко разрешение трябва да бъде изрично декларирано в манифеста на вашия app с ясно изявление за цел. Потребителите одобряват тези разрешения при инсталиране.

Управление на разрешения

Деклариране на разрешения

Добавете разрешения към вашия манифест 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"
    }
  ]
}

Добри практики за разрешения

Минимално необходимо: Заявявайте само разрешенията, действително използвани от вашия app
Ясни цели: Пишете изявления за цел, разбираеми за нетехнически потребители
Обосновавайте четене+запис: Ако се нуждаете от двете, обяснете защо
Преглеждайте редовно: Премахвайте ненужни разрешения при актуализиране

Tip

Заявяването на прекомерни разрешения е една от най-честите причини за отхвърляне на app. Заявявайте само това, от което се нуждаете.

Препоръчани разрешения за интеграцията Tajo Brevo

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

Caution

При заявяване на разрешения за запис бъдете готови да обясните по време на прегледа на app-а точно как и кога вашият app модифицира данни. Ненужните разрешения за запис са честа причина за отхвърляне.