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

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

Terminal window
# 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"

Лучшие практики разрешений

  • Минимально необходимые: Запрашивайте только те разрешения, которые приложение реально использует
  • Понятные цели: Пишите описания целей, понятные нетехническим пользователям
  • Обосновывайте read+write: Если нужны оба, объясняйте зачем в каждом описании цели
  • Регулярно пересматривайте: Удаляйте ненужные разрешения при обновлении приложения

Tip

Избыточные разрешения, одна из наиболее распространённых причин отклонения приложения. Запрашивайте только необходимое.

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

Основные

РесурсРазрешениеОписание
Accountaccount_readЧтение данных и настроек аккаунта
Accountaccount_writeОбновление настроек аккаунта
Balancebalance_readПросмотр баланса аккаунта и транзакций
Customercustomer_readЧтение профилей покупателей, метаданных и методов оплаты
Customercustomer_writeСоздание, обновление или удаление записей покупателей
Eventevent_readЧтение и подписка на события аккаунта
Filefile_readЧтение загруженных файлов
Filefile_writeЗагрузка файлов
Mandatemandate_readЧтение платёжных мандатов
Productproduct_readЧтение каталога товаров и цен
Productproduct_writeСоздание, обновление или удаление товаров и цен
Tokentoken_readЧтение токенизированных платёжных данных
Webhook Endpointwebhook_endpoint_readЧтение конфигураций вебхук-эндпоинтов
Webhook Endpointwebhook_endpoint_writeСоздание, обновление или удаление вебхук-эндпоинтов

Платежи

РесурсРазрешениеОписание
Chargecharge_readЧтение платежей и возвратов
Chargecharge_writeСоздание платежей, захват средств, возвраты
Disputedispute_readЧтение споров по платежам
Disputedispute_writeПодача доказательств и ответ на споры
Payment Intentpayment_intent_readЧтение деталей и статуса payment intent
Payment Intentpayment_intent_writeСоздание, подтверждение или отмена payment intent
Payment Methodpayment_method_readЧтение сохранённых методов оплаты
Payment Methodpayment_method_writeПривязка или отвязка методов оплаты
Payoutpayout_readЧтение выплат и расписаний
Payoutpayout_writeСоздание или отмена выплат
Refundrefund_readЧтение деталей возвратов
Refundrefund_writeСоздание или обновление возвратов
Setup Intentsetup_intent_readЧтение деталей setup intent
Setup Intentsetup_intent_writeСоздание или подтверждение setup intent

Выставление счетов

РесурсРазрешениеОписание
Couponcoupon_readЧтение купонов скидок и промо-кодов
Couponcoupon_writeСоздание, обновление или удаление купонов
Credit Notecredit_note_readЧтение кредит-нот
Credit Notecredit_note_writeСоздание или аннулирование кредит-нот
Invoiceinvoice_readЧтение счетов, позиций и статуса
Invoiceinvoice_writeСоздание, обновление, финализация или аннулирование счетов
Planplan_readЧтение планов подписки и цен
Planplan_writeСоздание, обновление или удаление планов
Priceprice_readЧтение конфигураций цен
Priceprice_writeСоздание или обновление цен
Quotequote_readЧтение ценовых предложений
Quotequote_writeСоздание, финализация или принятие предложений
Subscriptionsubscription_readЧтение деталей, расписаний и статуса подписок
Subscriptionsubscription_writeСоздание, обновление или отмена подписок
Usage Recordusage_record_readЧтение записей использования для тарифицированного биллинга
Usage Recordusage_record_writeСоздание записей использования

Checkout

РесурсРазрешениеОписание
Checkout Sessioncheckout_session_readЧтение деталей Checkout Session
Checkout Sessioncheckout_session_writeСоздание или завершение Checkout Sessions
Payment Linkpayment_link_readЧтение конфигураций Payment Link
Payment Linkpayment_link_writeСоздание или обновление Payment Links

Connect

РесурсРазрешениеОписание
Application Feeapplication_fee_readЧтение деталей комиссий приложения
Connected Accountconnected_account_readЧтение деталей подключённых аккаунтов
Connected Accountconnected_account_writeСоздание или обновление подключённых аккаунтов
Transfertransfer_readЧтение деталей переводов между аккаунтами
Transfertransfer_writeСоздание переводов на подключённые аккаунты

Secret Store

РесурсРазрешениеОписание
Secretsecret_readЧтение секретов из Secret Store
Secretsecret_writeСоздание, обновление или удаление секретов

Рекомендуемые разрешения для интеграции 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

При запросе разрешений на запись будьте готовы объяснить в процессе проверки, как именно и когда приложение изменяет данные. Ненужные разрешения на запись, частая причина отклонения.

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

AI-ассистент

Привет! Спрашивайте меня о документации.

Начните бесплатно с Brevo