Erken erişim talep edin

Adınızı ve e-posta adresinizi veya telefon numaranızı paylaşın. Tajo erişim ayrıntıları için sizinle iletişime geçeceğiz.

Bu sayfada

İzinler Referansı

Stripe Uygulamaları, Stripe API kaynaklarına erişimi denetlemek için bir izin sistemi kullanır. Her izin, uygulama manifestinizde net bir amaç açıklamasıyla birlikte açıkça bildirilmelidir. Kullanıcılar, uygulamanızı kurarken bu izinleri onaylar.

İzinleri yönetme

İzinleri bildirme

İzinleri stripe-app.json manifest dosyanıza ekleyin:

{
  "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 ile izin verme

Geliştirme sırasında izinleri Stripe CLI kullanarak verebilirsiniz:

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

İzinler için en iyi uygulamalar

Asgari gereklilik: Yalnızca uygulamanızın gerçekten kullandığı izinleri isteyin
Net amaçlar: Teknik olmayan kullanıcıların anlayabileceği amaç açıklamaları yazın
Okuma ve yazmayı gerekçelendirin: Hem okuma hem yazma gerekiyorsa nedenini her amaç açıklamasında belirtin
Düzenli olarak gözden geçirin: Uygulamanızı güncellerken artık gerekmeyen izinleri kaldırın

Tip

Aşırı izin istemek, uygulama reddedilmesinin en yaygın nedenlerinden biridir. Yalnızca ihtiyacınız olanı isteyin.

Ürüne göre izinler

Core

Kaynak	İzin	Açıklama
Account	`account_read`	Hesap ayrıntılarını ve ayarlarını okur
Account	`account_write`	Hesap ayarlarını günceller
Balance	`balance_read`	Hesap bakiyesini ve işlemleri görüntüler
Customer	`customer_read`	Müşteri profillerini, meta verilerini ve ödeme yöntemlerini okur
Customer	`customer_write`	Müşteri kayıtları oluşturur, günceller veya siler
Event	`event_read`	Hesap olaylarını okur ve bunlara abone olur
File	`file_read`	Yüklenen dosyaları ve dosya bağlantılarını okur
File	`file_write`	Dosya yükler ve dosya bağlantıları oluşturur
Mandate	`mandate_read`	Ödeme talimatlarını okur
Product	`product_read`	Ürün kataloğunu ve fiyatlandırmayı okur
Product	`product_write`	Ürün ve fiyat oluşturur, günceller veya siler
Token	`token_read`	Token’laştırılmış ödeme verilerini okur
Webhook Endpoint	`webhook_endpoint_read`	Webhook uç noktası yapılandırmalarını okur
Webhook Endpoint	`webhook_endpoint_write`	Webhook uç noktası oluşturur, günceller veya siler

Payments

Kaynak	İzin	Açıklama
Charge	`charge_read`	Ödeme tahsilatlarını ve iadelerini okur
Charge	`charge_write`	Tahsilat oluşturur, ödemeleri yakalar, iade yapar
Dispute	`dispute_read`	Ödeme itirazlarını ve kanıtlarını okur
Dispute	`dispute_write`	İtiraz kanıtı gönderir ve itirazları yanıtlar
Payment Intent	`payment_intent_read`	Ödeme niyeti ayrıntılarını ve durumunu okur
Payment Intent	`payment_intent_write`	Ödeme niyeti oluşturur, onaylar veya iptal eder
Payment Method	`payment_method_read`	Kayıtlı ödeme yöntemlerini okur
Payment Method	`payment_method_write`	Ödeme yöntemlerini müşterilere ekler veya müşterilerden ayırır
Payout	`payout_read`	Ödeme aktarımı ayrıntılarını ve takvimlerini okur
Payout	`payout_write`	Ödeme aktarımı oluşturur veya iptal eder
Refund	`refund_read`	İade ayrıntılarını okur
Refund	`refund_write`	İade oluşturur veya günceller
Setup Intent	`setup_intent_read`	Kurulum niyeti ayrıntılarını okur
Setup Intent	`setup_intent_write`	Kurulum niyeti oluşturur veya onaylar

Billing

Kaynak	İzin	Açıklama
Coupon	`coupon_read`	İndirim kuponlarını ve promosyon kodlarını okur
Coupon	`coupon_write`	Kupon oluşturur, günceller veya siler
Credit Note	`credit_note_read`	Alacak dekontlarını okur
Credit Note	`credit_note_write`	Alacak dekontu oluşturur veya geçersiz kılar
Invoice	`invoice_read`	Fatura ayrıntılarını, kalemlerini ve durumunu okur
Invoice	`invoice_write`	Fatura oluşturur, günceller, kesinleştirir veya geçersiz kılar
Invoice Item	`invoice_item_read`	Bekleyen fatura kalemlerini okur
Invoice Item	`invoice_item_write`	Fatura kalemi oluşturur veya siler
Plan	`plan_read`	Abonelik planlarını ve fiyatlandırmayı okur
Plan	`plan_write`	Plan oluşturur, günceller veya siler
Price	`price_read`	Fiyat yapılandırmalarını okur
Price	`price_write`	Fiyat oluşturur veya günceller
Quote	`quote_read`	Fiyat tekliflerini okur
Quote	`quote_write`	Teklif oluşturur, kesinleştirir veya kabul eder
Subscription	`subscription_read`	Abonelik ayrıntılarını, takvimlerini ve durumunu okur
Subscription	`subscription_write`	Abonelik oluşturur, günceller veya iptal eder
Subscription Schedule	`subscription_schedule_read`	Abonelik takvimlerini okur
Subscription Schedule	`subscription_schedule_write`	Abonelik takvimi oluşturur, günceller veya serbest bırakır
Usage Record	`usage_record_read`	Kullanıma dayalı faturalandırma kullanım kayıtlarını okur
Usage Record	`usage_record_write`	Kullanıma dayalı faturalandırma için kullanım kaydı oluşturur

Checkout

Kaynak	İzin	Açıklama
Checkout Session	`checkout_session_read`	Checkout Session ayrıntılarını ve kalemlerini okur
Checkout Session	`checkout_session_write`	Checkout Session oluşturur veya süresini doldurur
Payment Link	`payment_link_read`	Payment Link yapılandırmalarını okur
Payment Link	`payment_link_write`	Payment Link oluşturur veya günceller

Connect

Kaynak	İzin	Açıklama
Application Fee	`application_fee_read`	Uygulama ücreti ayrıntılarını okur
Connected Account	`connected_account_read`	Bağlı hesap ayrıntılarını okur
Connected Account	`connected_account_write`	Bağlı hesap oluşturur veya günceller
Transfer	`transfer_read`	Hesaplar arası aktarım ayrıntılarını okur
Transfer	`transfer_write`	Bağlı hesaplara aktarım oluşturur
Top-up	`topup_read`	Bakiye yükleme ayrıntılarını okur
Top-up	`topup_write`	Stripe bakiyesine yükleme yapar

Issuing

Kaynak	İzin	Açıklama
Issuing Card	`issuing_card_read`	Basılan kart ayrıntılarını okur
Issuing Card	`issuing_card_write`	Kart oluşturur, günceller veya devre dışı bırakır
Issuing Cardholder	`issuing_cardholder_read`	Kart sahibi bilgilerini okur
Issuing Cardholder	`issuing_cardholder_write`	Kart sahibi oluşturur veya günceller
Issuing Transaction	`issuing_transaction_read`	Kart işlemi ayrıntılarını okur
Issuing Authorization	`issuing_authorization_read`	Yetkilendirme taleplerini okur
Issuing Authorization	`issuing_authorization_write`	Yetkilendirme taleplerini onaylar veya reddeder
Issuing Dispute	`issuing_dispute_read`	Kart itirazlarını okur
Issuing Dispute	`issuing_dispute_write`	Kart itirazı oluşturur veya gönderir

Reporting

Kaynak	İzin	Açıklama
Report Run	`report_run_read`	Rapor çalıştırma sonuçlarını okur
Report Run	`report_run_write`	Yeni rapor çalıştırmaları oluşturur
Report Type	`report_type_read`	Kullanılabilir rapor türlerini okur

Tax

Kaynak	İzin	Açıklama
Tax Calculation	`tax_calculation_read`	Vergi hesaplama sonuçlarını okur
Tax Calculation	`tax_calculation_write`	Vergi hesaplaması oluşturur
Tax Rate	`tax_rate_read`	Vergi oranı yapılandırmalarını okur
Tax Rate	`tax_rate_write`	Vergi oranı oluşturur veya günceller
Tax Registration	`tax_registration_read`	Vergi kaydı ayrıntılarını okur

Terminal

Kaynak	İzin	Açıklama
Terminal Reader	`terminal_reader_read`	Terminal okuyucu ayrıntılarını okur
Terminal Reader	`terminal_reader_write`	Terminal okuyucu kaydeder veya günceller
Terminal Location	`terminal_location_read`	Terminal konumu ayrıntılarını okur
Terminal Location	`terminal_location_write`	Terminal konumu oluşturur veya günceller

Secret Store

Kaynak	İzin	Açıklama
Secret	`secret_read`	Secret Store içindeki gizli anahtarları okur
Secret	`secret_write`	Gizli anahtar oluşturur, günceller veya siler

Tajo Brevo entegrasyonu için önerilen izinler

Tajo Brevo entegrasyon uygulaması için önerilen izinler şunlardır:

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

İzin kapsamları

İzinler, uygulamanızın bir platform hesabına mı yoksa bağlı bir hesaba mı kurulduğuna bağlı olarak farklı kapsamlarda çalışabilir:

Kapsam	Açıklama
Account	İzinler, kurulumu yapan hesabın kendi verileri için geçerlidir
Connected Account	Connect platformlarında izinler bağlı hesapları da kapsayabilir

Caution

Yazma izni isterken, uygulamanızın verileri tam olarak nasıl ve ne zaman değiştirdiğini uygulama incelemesi sırasında açıklamaya hazır olun. Gereksiz yazma izinleri, yaygın bir ret nedenidir.