Permissions حوالہ

Stripe Apps Stripe API وسائل تک رسائی کنٹرول کرنے کے لیے اجازت کا نظام استعمال کرتے ہیں۔ ہر اجازت واضح مقصد کے بیان کے ساتھ app manifest میں صریحاً بیان ہونی چاہیے۔ صارفین app انسٹال کرتے وقت ان اجازتوں کو منظور کرتے ہیں۔

Permissions کا انتظام

Permissions بیان کرنا

اپنے stripe-app.json manifest میں permissions شامل کریں:

{
"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 کے ذریعے Permissions دینا

ترقی کے دوران، آپ Stripe CLI استعمال کرکے permissions دے سکتے ہیں:

Terminal window
# مخصوص اجازت دیں
stripe apps grant permission "customer_read" \
--purpose "Read customer profiles to sync with Brevo contacts"
# متعدد اجازتیں دیں
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"

Permissions کے بہترین طریقے

  • کم سے کم ضروری: صرف وہ اجازتیں مانگیں جو app واقعی استعمال کرتی ہے
  • واضح مقاصد: ایسے مقصد کے بیانات لکھیں جو غیر تکنیکی صارفین سمجھ سکیں
  • read+write کا جواز: اگر دونوں read اور write کی ضرورت ہو، تو ہر مقصد میں وجہ بتائیں
  • باقاعدہ جائزہ: app اپ ڈیٹ کرتے وقت وہ اجازتیں ہٹائیں جن کی اب ضرورت نہیں

Tip

ضرورت سے زیادہ اجازتیں مانگنا app مسترد ہونے کی سب سے عام وجوہات میں سے ایک ہے۔ صرف وہ مانگیں جو ضروری ہے۔

مصنوع کے لحاظ سے Permissions

Core

وسیلہPermissionتفصیل
Accountaccount_readاکاؤنٹ کی تفصیلات اور ترتیبات پڑھیں
Accountaccount_writeاکاؤنٹ کی ترتیبات اپ ڈیٹ کریں
Balancebalance_readاکاؤنٹ بیلنس اور لین دین دیکھیں
Customercustomer_readگاہک کے پروفائلز، metadata اور ادائیگی کے طریقے پڑھیں
Customercustomer_writeگاہک کے ریکارڈ بنائیں، اپ ڈیٹ یا حذف کریں
Eventevent_readاکاؤنٹ events پڑھیں اور subscribe کریں
Filefile_readاپلوڈ کردہ files اور file links پڑھیں
Filefile_writeFiles اپلوڈ کریں اور file links بنائیں
Mandatemandate_readادائیگی mandates پڑھیں
Productproduct_readمصنوع کیٹالاگ اور قیمت پڑھیں
Productproduct_writeمصنوعات اور قیمتیں بنائیں، اپ ڈیٹ یا حذف کریں
Tokentoken_readTokenize کردہ ادائیگی ڈیٹا پڑھیں
Webhook Endpointwebhook_endpoint_readWebhook endpoint کنفیگریشنز پڑھیں
Webhook Endpointwebhook_endpoint_writeWebhook endpoints بنائیں، اپ ڈیٹ یا حذف کریں

ادائیگیاں

وسیلہPermissionتفصیل
Chargecharge_readادائیگی charges اور refunds پڑھیں
Chargecharge_writeCharges بنائیں، ادائیگیاں capture کریں، refunds جاری کریں
Disputedispute_readادائیگی تنازعات اور ثبوت پڑھیں
Disputedispute_writeتنازعہ کا ثبوت جمع کریں اور جواب دیں
Payment Intentpayment_intent_readPayment intent کی تفصیلات اور status پڑھیں
Payment Intentpayment_intent_writePayment intents بنائیں، تصدیق یا منسوخ کریں
Payment Methodpayment_method_readمحفوظ کردہ ادائیگی کے طریقے پڑھیں
Payment Methodpayment_method_writeگاہکوں سے ادائیگی کے طریقے منسلک یا الگ کریں
Payoutpayout_readPayout کی تفصیلات اور شیڈول پڑھیں
Payoutpayout_writePayouts بنائیں یا منسوخ کریں
Refundrefund_readRefund کی تفصیلات پڑھیں
Refundrefund_writeRefunds بنائیں یا اپ ڈیٹ کریں
Setup Intentsetup_intent_readSetup intent کی تفصیلات پڑھیں
Setup Intentsetup_intent_writeSetup intents بنائیں یا تصدیق کریں

بلنگ

وسیلہPermissionتفصیل
Couponcoupon_readرعایتی کوپنز اور پروموشن کوڈز پڑھیں
Couponcoupon_writeCoupons بنائیں، اپ ڈیٹ یا حذف کریں
Credit Notecredit_note_readCredit notes پڑھیں
Credit Notecredit_note_writeCredit notes بنائیں یا باطل کریں
Invoiceinvoice_readانوائس کی تفصیلات، اشیاء اور status پڑھیں
Invoiceinvoice_writeانوائسز بنائیں، اپ ڈیٹ، حتمی یا باطل کریں
Invoice Iteminvoice_item_readزیر التواء انوائس اشیاء پڑھیں
Invoice Iteminvoice_item_writeانوائس اشیاء بنائیں یا حذف کریں
Planplan_readسبسکرپشن plans اور قیمت پڑھیں
Planplan_writePlans بنائیں، اپ ڈیٹ یا حذف کریں
Priceprice_readقیمت کنفیگریشنز پڑھیں
Priceprice_writeقیمتیں بنائیں یا اپ ڈیٹ کریں
Quotequote_readقیمتی حوالہ جات پڑھیں
Quotequote_writeQuotes بنائیں، حتمی یا قبول کریں
Subscriptionsubscription_readسبسکرپشن کی تفصیلات، شیڈولز اور status پڑھیں
Subscriptionsubscription_writeسبسکرپشنز بنائیں، اپ ڈیٹ یا منسوخ کریں
Subscription Schedulesubscription_schedule_readسبسکرپشن شیڈولز پڑھیں
Subscription Schedulesubscription_schedule_writeسبسکرپشن شیڈولز بنائیں، اپ ڈیٹ یا ریلیز کریں
Usage Recordusage_record_readMetered billing استعمال کے ریکارڈ پڑھیں
Usage Recordusage_record_writeMetered billing کے لیے استعمال ریکارڈ بنائیں

Checkout

وسیلہPermissionتفصیل
Checkout Sessioncheckout_session_readCheckout Session کی تفصیلات اور اشیاء پڑھیں
Checkout Sessioncheckout_session_writeCheckout Sessions بنائیں یا ختم کریں
Payment Linkpayment_link_readPayment Link کنفیگریشنز پڑھیں
Payment Linkpayment_link_writePayment Links بنائیں یا اپ ڈیٹ کریں

Connect

وسیلہPermissionتفصیل
Application Feeapplication_fee_readApplication fee کی تفصیلات پڑھیں
Connected Accountconnected_account_readمنسلک اکاؤنٹ کی تفصیلات پڑھیں
Connected Accountconnected_account_writeمنسلک اکاؤنٹ بنائیں یا اپ ڈیٹ کریں
Transfertransfer_readاکاؤنٹس کے درمیان transfer کی تفصیلات پڑھیں
Transfertransfer_writeمنسلک اکاؤنٹس کو transfers بنائیں
Top-uptopup_readTop-up کی تفصیلات پڑھیں
Top-uptopup_writeStripe بیلنس کے لیے top-ups بنائیں

Issuing

وسیلہPermissionتفصیل
Issuing Cardissuing_card_readجاری کردہ کارڈ کی تفصیلات پڑھیں
Issuing Cardissuing_card_writeجاری کردہ کارڈز بنائیں، اپ ڈیٹ یا غیر فعال کریں
Issuing Cardholderissuing_cardholder_readکارڈ ہولڈر کی معلومات پڑھیں
Issuing Cardholderissuing_cardholder_writeکارڈ ہولڈرز بنائیں یا اپ ڈیٹ کریں
Issuing Transactionissuing_transaction_readکارڈ لین دین کی تفصیلات پڑھیں
Issuing Authorizationissuing_authorization_readاجازت کی درخواستیں پڑھیں
Issuing Authorizationissuing_authorization_writeاجازت کی درخواستیں منظور یا مسترد کریں
Issuing Disputeissuing_dispute_readIssuing تنازعات پڑھیں
Issuing Disputeissuing_dispute_writeIssuing تنازعات بنائیں یا جمع کرائیں

رپورٹنگ

وسیلہPermissionتفصیل
Report Runreport_run_readReport run نتائج پڑھیں
Report Runreport_run_writeنئے report runs بنائیں
Report Typereport_type_readدستیاب رپورٹ کی اقسام پڑھیں

ٹیکس

وسیلہPermissionتفصیل
Tax Calculationtax_calculation_readٹیکس حساب کے نتائج پڑھیں
Tax Calculationtax_calculation_writeٹیکس حسابات بنائیں
Tax Ratetax_rate_readٹیکس کی شرح کنفیگریشنز پڑھیں
Tax Ratetax_rate_writeٹیکس کی شرحیں بنائیں یا اپ ڈیٹ کریں
Tax Registrationtax_registration_readٹیکس رجسٹریشن کی تفصیلات پڑھیں

Terminal

وسیلہPermissionتفصیل
Terminal Readerterminal_reader_readTerminal reader کی تفصیلات پڑھیں
Terminal Readerterminal_reader_writeTerminal readers رجسٹر یا اپ ڈیٹ کریں
Terminal Locationterminal_location_readTerminal مقام کی تفصیلات پڑھیں
Terminal Locationterminal_location_writeTerminal مقامات بنائیں یا اپ ڈیٹ کریں

Secret Store

وسیلہPermissionتفصیل
Secretsecret_readSecret Store سے secrets پڑھیں
Secretsecret_writeSecrets بنائیں، اپ ڈیٹ یا حذف کریں

Tajo Brevo انٹیگریشن کے لیے تجویز کردہ Permissions

Tajo Brevo انٹیگریشن app کے لیے، یہ تجویز کردہ permissions ہیں:

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

Permission Scopes

اجازتیں مختلف scopes پر کام کر سکتی ہیں اس بات پر منحصر کہ آپ کی app کسی پلیٹ فارم اکاؤنٹ یا منسلک اکاؤنٹ پر انسٹال ہے:

Scopeتفصیل
AccountPermissions انسٹال کرنے والے اکاؤنٹ کے اپنے ڈیٹا پر لاگو ہوتی ہیں
Connected AccountConnect platforms کے لیے، permissions منسلک اکاؤنٹس تک پھیل سکتی ہیں

Caution

Write permissions مانگتے وقت، app جائزہ کے دوران بالکل بتانے کے لیے تیار رہیں کہ آپ کی app ڈیٹا کیسے اور کب تبدیل کرتی ہے۔ غیر ضروری write permissions مسترد ہونے کی عام وجہ ہے۔

Subscribe to updates

developer-docs

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

AI معاون

السلام علیکم! دستاویزات کے بارے میں کچھ بھی پوچھیں۔

Brevo کے ساتھ مفت شروع کریں