مرجع الأذونات

تستخدم تطبيقات Stripe نظام أذونات للتحكم في الوصول إلى موارد Stripe API. يجب الإعلان صراحة عن كل إذن في manifest التطبيق مع بيان غرض واضح. يوافق المستخدمون على هذه الأذونات عند تثبيت التطبيق.

إدارة الأذونات

الإعلان عن الأذونات

أضف الأذونات إلى ملف 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:

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"
stripe apps grant permission "event_read" \
--purpose "Subscribe to real-time Stripe events"

أفضل الممارسات للأذونات

  • الحد الأدنى الضروري: اطلب فقط الأذونات التي يستخدمها تطبيقك فعلاً
  • أغراض واضحة: اكتب بيانات غرض يمكن للمستخدمين غير التقنيين فهمها
  • تبرير القراءة+الكتابة: إذا كنت بحاجة لكليهما، اشرح السبب في كل غرض
  • مراجعة منتظمة: احذف الأذونات غير المستخدمة عند تحديث تطبيقك

Tip

طلب أذونات مفرطة هو أحد أكثر أسباب رفض التطبيقات شيوعًا. اطلب فقط ما تحتاجه.

الأذونات حسب المنتج

الأساسي

الموردالإذنالوصف
الحسابaccount_readقراءة تفاصيل وإعدادات الحساب
الحسابaccount_writeتحديث إعدادات الحساب
الرصيدbalance_readعرض رصيد الحساب والمعاملات
العميلcustomer_readقراءة ملفات العملاء والبيانات الوصفية وطرق الدفع
العميلcustomer_writeإنشاء أو تحديث أو حذف سجلات العملاء
الحدثevent_readقراءة والاشتراك في أحداث الحساب
الملفfile_readقراءة الملفات المرفوعة وروابط الملفات
الملفfile_writeرفع الملفات وإنشاء روابط الملفات
التفويضmandate_readقراءة تفويضات الدفع
المنتجproduct_readقراءة كتالوج المنتجات والتسعير
المنتجproduct_writeإنشاء أو تحديث أو حذف المنتجات والأسعار
الرمزtoken_readقراءة بيانات الدفع المرمّزة
نقطة نهاية Webhookwebhook_endpoint_readقراءة تكوينات نقاط نهاية webhook
نقطة نهاية Webhookwebhook_endpoint_writeإنشاء أو تحديث أو حذف نقاط نهاية webhook

المدفوعات

الموردالإذنالوصف
الرسومcharge_readقراءة رسوم الدفع والمبالغ المستردة
الرسومcharge_writeإنشاء الرسوم وتسجيل المدفوعات وإصدار المبالغ المستردة
النزاعdispute_readقراءة نزاعات الدفع والأدلة
النزاعdispute_writeتقديم أدلة النزاع والرد على النزاعات
نية الدفعpayment_intent_readقراءة تفاصيل وحالة نية الدفع
نية الدفعpayment_intent_writeإنشاء أو تأكيد أو إلغاء نوايا الدفع
طريقة الدفعpayment_method_readقراءة طرق الدفع المحفوظة
طريقة الدفعpayment_method_writeربط أو فصل طرق الدفع من العملاء
التحويلpayout_readقراءة تفاصيل وجداول التحويلات
التحويلpayout_writeإنشاء أو إلغاء التحويلات
الاستردادrefund_readقراءة تفاصيل الاسترداد
الاستردادrefund_writeإنشاء أو تحديث المبالغ المستردة
نية الإعدادsetup_intent_readقراءة تفاصيل نية الإعداد
نية الإعدادsetup_intent_writeإنشاء أو تأكيد نوايا الإعداد

الفوترة

الموردالإذنالوصف
القسيمةcoupon_readقراءة قسائم الخصم ورموز العروض
القسيمةcoupon_writeإنشاء أو تحديث أو حذف القسائم
إشعار ائتمانcredit_note_readقراءة إشعارات الائتمان
إشعار ائتمانcredit_note_writeإنشاء أو إبطال إشعارات الائتمان
الفاتورةinvoice_readقراءة تفاصيل الفواتير وبنودها وحالتها
الفاتورةinvoice_writeإنشاء أو تحديث أو إنهاء أو إبطال الفواتير
بند الفاتورةinvoice_item_readقراءة بنود الفاتورة المعلقة
بند الفاتورةinvoice_item_writeإنشاء أو حذف بنود الفاتورة
الخطةplan_readقراءة خطط الاشتراك والتسعير
الخطةplan_writeإنشاء أو تحديث أو حذف الخطط
السعرprice_readقراءة تكوينات الأسعار
السعرprice_writeإنشاء أو تحديث الأسعار
عرض السعرquote_readقراءة عروض الأسعار
عرض السعرquote_writeإنشاء أو إنهاء أو قبول عروض الأسعار
الاشتراكsubscription_readقراءة تفاصيل الاشتراكات والجداول والحالة
الاشتراكsubscription_writeإنشاء أو تحديث أو إلغاء الاشتراكات
جدول الاشتراكsubscription_schedule_readقراءة جداول الاشتراكات
جدول الاشتراكsubscription_schedule_writeإنشاء أو تحديث أو تحرير جداول الاشتراكات
سجل الاستخدامusage_record_readقراءة سجلات استخدام الفوترة المقاسة
سجل الاستخدامusage_record_writeإنشاء سجلات استخدام للفوترة المقاسة

Checkout

الموردالإذنالوصف
جلسة Checkoutcheckout_session_readقراءة تفاصيل وبنود جلسة Checkout
جلسة Checkoutcheckout_session_writeإنشاء أو إنهاء جلسات Checkout
رابط الدفعpayment_link_readقراءة تكوينات روابط الدفع
رابط الدفعpayment_link_writeإنشاء أو تحديث روابط الدفع

Connect

الموردالإذنالوصف
رسوم التطبيقapplication_fee_readقراءة تفاصيل رسوم التطبيق
الحساب المتصلconnected_account_readقراءة تفاصيل الحساب المتصل
الحساب المتصلconnected_account_writeإنشاء أو تحديث الحسابات المتصلة
التحويلtransfer_readقراءة تفاصيل التحويلات بين الحسابات
التحويلtransfer_writeإنشاء تحويلات إلى الحسابات المتصلة
الشحنtopup_readقراءة تفاصيل الشحن
الشحنtopup_writeإنشاء عمليات شحن لرصيد Stripe

Issuing

الموردالإذنالوصف
بطاقة Issuingissuing_card_readقراءة تفاصيل البطاقات المُصدرة
بطاقة Issuingissuing_card_writeإنشاء أو تحديث أو تعطيل البطاقات المُصدرة
حامل بطاقة Issuingissuing_cardholder_readقراءة معلومات حامل البطاقة
حامل بطاقة Issuingissuing_cardholder_writeإنشاء أو تحديث حاملي البطاقات
معاملة Issuingissuing_transaction_readقراءة تفاصيل معاملات البطاقات
تفويض Issuingissuing_authorization_readقراءة طلبات التفويض
تفويض Issuingissuing_authorization_writeالموافقة على أو رفض طلبات التفويض
نزاع Issuingissuing_dispute_readقراءة نزاعات الإصدار
نزاع Issuingissuing_dispute_writeإنشاء أو تقديم نزاعات الإصدار

التقارير

الموردالإذنالوصف
تشغيل التقريرreport_run_readقراءة نتائج تشغيل التقارير
تشغيل التقريرreport_run_writeإنشاء عمليات تشغيل تقارير جديدة
نوع التقريرreport_type_readقراءة أنواع التقارير المتاحة

الضرائب

الموردالإذنالوصف
حساب الضريبةtax_calculation_readقراءة نتائج حساب الضريبة
حساب الضريبةtax_calculation_writeإنشاء حسابات ضريبية
معدل الضريبةtax_rate_readقراءة تكوينات معدلات الضريبة
معدل الضريبةtax_rate_writeإنشاء أو تحديث معدلات الضريبة
تسجيل ضريبيtax_registration_readقراءة تفاصيل التسجيل الضريبي

Terminal

الموردالإذنالوصف
قارئ Terminalterminal_reader_readقراءة تفاصيل قارئ الطرفية
قارئ Terminalterminal_reader_writeتسجيل أو تحديث قراء الطرفية
موقع Terminalterminal_location_readقراءة تفاصيل موقع الطرفية
موقع Terminalterminal_location_writeإنشاء أو تحديث مواقع الطرفية

Secret Store

الموردالإذنالوصف
السرsecret_readقراءة الأسرار من Secret Store
السرsecret_writeإنشاء أو تحديث أو حذف الأسرار

الأذونات الموصى بها لتكامل 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"
}
]
}

نطاقات الأذونات

يمكن أن تعمل الأذونات بنطاقات مختلفة حسب ما إذا كان تطبيقك مثبتًا على حساب منصة أو حساب متصل:

النطاقالوصف
الحسابالأذونات تنطبق على بيانات الحساب المُثبِّت
الحساب المتصللمنصات Connect، يمكن أن تمتد الأذونات للحسابات المتصلة

Caution

عند طلب أذونات الكتابة، كن مستعدًا لشرح أثناء مراجعة التطبيق كيف ومتى يعدل تطبيقك البيانات بالضبط. أذونات الكتابة غير الضرورية هي سبب شائع للرفض.

Subscribe to updates

developer-docs

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

مساعد AI

مرحباً! اسألني أي شيء عن الوثائق.

ابدأ مجانًا مع Brevo