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

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

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

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

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

Предоставяне на разрешения през CLI

По време на разработка можете да предоставяте разрешения с 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"

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

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

Разрешения по продукт

Core

Payments

Billing

Checkout

Connect

Issuing

Reporting

Tax

Terminal

Secret Store

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

За приложението за интеграция 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"
    }
  ]
}

Обхвати на разрешенията

Разрешенията могат да действат в различни обхвати в зависимост от това дали приложението Ви е инсталирано на платформен акаунт, или на свързан акаунт: