Permissions حوالہ
Stripe Apps Stripe API وسائل تک رسائی کنٹرول کرنے کے لیے اجازت کا نظام استعمال کرتے ہیں۔ ہر اجازت واضح مقصد کے بیان کے ساتھ app manifest میں صریحاً بیان ہونی چاہیے۔ صارفین app انسٹال کرتے وقت ان اجازتوں کو منظور کرتے ہیں۔
Caution
صورتحال: منصوبہ بند۔ Stripe App Marketplace میں ابھی تک کوئی Tajo ایپ موجود نہیں۔ اس صفحے میں دیے گئے ایپ کے شناخت کار، URLs اور کریڈنشلز مثال کے طور پر رکھے گئے پلیس ہولڈرز ہیں، لائیو اینڈ پوائنٹس نہیں۔
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 دے سکتے ہیں:
# Grant a specific permissionstripe apps grant permission "customer_read" \ --purpose "Read customer profiles to sync with Brevo contacts"
# Grant multiple permissionsstripe 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 | تفصیل |
|---|---|---|
| Account | account_read | اکاؤنٹ کی تفصیلات اور ترتیبات پڑھیں |
| Account | account_write | اکاؤنٹ کی ترتیبات اپ ڈیٹ کریں |
| Balance | balance_read | اکاؤنٹ بیلنس اور لین دین دیکھیں |
| Customer | customer_read | گاہک کے پروفائلز، metadata اور ادائیگی کے طریقے پڑھیں |
| Customer | customer_write | گاہک کے ریکارڈ بنائیں، اپ ڈیٹ یا حذف کریں |
| Event | event_read | اکاؤنٹ events پڑھیں اور subscribe کریں |
| File | file_read | اپلوڈ کردہ files اور file links پڑھیں |
| File | file_write | Files اپلوڈ کریں اور file links بنائیں |
| Mandate | mandate_read | ادائیگی mandates پڑھیں |
| Product | product_read | مصنوع کیٹالاگ اور قیمت پڑھیں |
| Product | product_write | مصنوعات اور قیمتیں بنائیں، اپ ڈیٹ یا حذف کریں |
| Token | token_read | Tokenize کردہ ادائیگی ڈیٹا پڑھیں |
| Webhook Endpoint | webhook_endpoint_read | Webhook endpoint کنفیگریشنز پڑھیں |
| Webhook Endpoint | webhook_endpoint_write | Webhook endpoints بنائیں، اپ ڈیٹ یا حذف کریں |
ادائیگیاں
| وسیلہ | Permission | تفصیل |
|---|---|---|
| Charge | charge_read | ادائیگی charges اور refunds پڑھیں |
| Charge | charge_write | Charges بنائیں، ادائیگیاں capture کریں، refunds جاری کریں |
| Dispute | dispute_read | ادائیگی تنازعات اور ثبوت پڑھیں |
| Dispute | dispute_write | تنازعہ کا ثبوت جمع کریں اور جواب دیں |
| Payment Intent | payment_intent_read | Payment intent کی تفصیلات اور status پڑھیں |
| Payment Intent | payment_intent_write | Payment intents بنائیں، تصدیق یا منسوخ کریں |
| Payment Method | payment_method_read | محفوظ کردہ ادائیگی کے طریقے پڑھیں |
| Payment Method | payment_method_write | گاہکوں سے ادائیگی کے طریقے منسلک یا الگ کریں |
| Payout | payout_read | Payout کی تفصیلات اور شیڈول پڑھیں |
| Payout | payout_write | Payouts بنائیں یا منسوخ کریں |
| Refund | refund_read | Refund کی تفصیلات پڑھیں |
| Refund | refund_write | Refunds بنائیں یا اپ ڈیٹ کریں |
| Setup Intent | setup_intent_read | Setup intent کی تفصیلات پڑھیں |
| Setup Intent | setup_intent_write | Setup intents بنائیں یا تصدیق کریں |
بلنگ
| وسیلہ | Permission | تفصیل |
|---|---|---|
| Coupon | coupon_read | رعایتی کوپنز اور پروموشن کوڈز پڑھیں |
| Coupon | coupon_write | Coupons بنائیں، اپ ڈیٹ یا حذف کریں |
| Credit Note | credit_note_read | Credit notes پڑھیں |
| Credit Note | credit_note_write | Credit notes بنائیں یا باطل کریں |
| Invoice | invoice_read | انوائس کی تفصیلات، اشیاء اور status پڑھیں |
| Invoice | invoice_write | انوائسز بنائیں، اپ ڈیٹ، حتمی یا باطل کریں |
| Invoice Item | invoice_item_read | زیر التواء انوائس اشیاء پڑھیں |
| Invoice Item | invoice_item_write | انوائس اشیاء بنائیں یا حذف کریں |
| Plan | plan_read | سبسکرپشن plans اور قیمت پڑھیں |
| Plan | plan_write | Plans بنائیں، اپ ڈیٹ یا حذف کریں |
| Price | price_read | قیمت کنفیگریشنز پڑھیں |
| Price | price_write | قیمتیں بنائیں یا اپ ڈیٹ کریں |
| Quote | quote_read | قیمتی حوالہ جات پڑھیں |
| Quote | quote_write | Quotes بنائیں، حتمی یا قبول کریں |
| Subscription | subscription_read | سبسکرپشن کی تفصیلات، شیڈولز اور status پڑھیں |
| Subscription | subscription_write | سبسکرپشنز بنائیں، اپ ڈیٹ یا منسوخ کریں |
| Subscription Schedule | subscription_schedule_read | سبسکرپشن شیڈولز پڑھیں |
| Subscription Schedule | subscription_schedule_write | سبسکرپشن شیڈولز بنائیں، اپ ڈیٹ یا ریلیز کریں |
| Usage Record | usage_record_read | Metered billing استعمال کے ریکارڈ پڑھیں |
| Usage Record | usage_record_write | Metered billing کے لیے استعمال ریکارڈ بنائیں |
Checkout
| وسیلہ | Permission | تفصیل |
|---|---|---|
| Checkout Session | checkout_session_read | Checkout Session کی تفصیلات اور اشیاء پڑھیں |
| Checkout Session | checkout_session_write | Checkout Sessions بنائیں یا ختم کریں |
| Payment Link | payment_link_read | Payment Link کنفیگریشنز پڑھیں |
| Payment Link | payment_link_write | Payment Links بنائیں یا اپ ڈیٹ کریں |
Connect
| وسیلہ | Permission | تفصیل |
|---|---|---|
| Application Fee | application_fee_read | Application fee کی تفصیلات پڑھیں |
| Connected Account | connected_account_read | منسلک اکاؤنٹ کی تفصیلات پڑھیں |
| Connected Account | connected_account_write | منسلک اکاؤنٹ بنائیں یا اپ ڈیٹ کریں |
| Transfer | transfer_read | اکاؤنٹس کے درمیان transfer کی تفصیلات پڑھیں |
| Transfer | transfer_write | منسلک اکاؤنٹس کو transfers بنائیں |
| Top-up | topup_read | Top-up کی تفصیلات پڑھیں |
| Top-up | topup_write | Stripe بیلنس کے لیے top-ups بنائیں |
Issuing
| وسیلہ | Permission | تفصیل |
|---|---|---|
| Issuing Card | issuing_card_read | جاری کردہ کارڈ کی تفصیلات پڑھیں |
| Issuing Card | issuing_card_write | جاری کردہ کارڈز بنائیں، اپ ڈیٹ یا غیر فعال کریں |
| Issuing Cardholder | issuing_cardholder_read | کارڈ ہولڈر کی معلومات پڑھیں |
| Issuing Cardholder | issuing_cardholder_write | کارڈ ہولڈرز بنائیں یا اپ ڈیٹ کریں |
| Issuing Transaction | issuing_transaction_read | کارڈ لین دین کی تفصیلات پڑھیں |
| Issuing Authorization | issuing_authorization_read | اجازت کی درخواستیں پڑھیں |
| Issuing Authorization | issuing_authorization_write | اجازت کی درخواستیں منظور یا مسترد کریں |
| Issuing Dispute | issuing_dispute_read | Issuing تنازعات پڑھیں |
| Issuing Dispute | issuing_dispute_write | Issuing تنازعات بنائیں یا جمع کرائیں |
رپورٹنگ
| وسیلہ | Permission | تفصیل |
|---|---|---|
| Report Run | report_run_read | Report run نتائج پڑھیں |
| Report Run | report_run_write | نئے report runs بنائیں |
| Report Type | report_type_read | دستیاب رپورٹ کی اقسام پڑھیں |
ٹیکس
| وسیلہ | Permission | تفصیل |
|---|---|---|
| Tax Calculation | tax_calculation_read | ٹیکس حساب کے نتائج پڑھیں |
| Tax Calculation | tax_calculation_write | ٹیکس حسابات بنائیں |
| Tax Rate | tax_rate_read | ٹیکس کی شرح کنفیگریشنز پڑھیں |
| Tax Rate | tax_rate_write | ٹیکس کی شرحیں بنائیں یا اپ ڈیٹ کریں |
| Tax Registration | tax_registration_read | ٹیکس رجسٹریشن کی تفصیلات پڑھیں |
Terminal
| وسیلہ | Permission | تفصیل |
|---|---|---|
| Terminal Reader | terminal_reader_read | Terminal reader کی تفصیلات پڑھیں |
| Terminal Reader | terminal_reader_write | Terminal readers رجسٹر یا اپ ڈیٹ کریں |
| Terminal Location | terminal_location_read | Terminal مقام کی تفصیلات پڑھیں |
| Terminal Location | terminal_location_write | Terminal مقامات بنائیں یا اپ ڈیٹ کریں |
Secret Store
| وسیلہ | Permission | تفصیل |
|---|---|---|
| Secret | secret_read | Secret Store سے secrets پڑھیں |
| Secret | secret_write | Secrets بنائیں، اپ ڈیٹ یا حذف کریں |
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 | تفصیل |
|---|---|
| Account | Permissions انسٹال کرنے والے اکاؤنٹ کے اپنے ڈیٹا پر لاگو ہوتی ہیں |
| Connected Account | Connect platforms کے لیے، permissions منسلک اکاؤنٹس تک پھیل سکتی ہیں |
Caution
Write permissions مانگتے وقت، app جائزہ کے دوران بالکل بتانے کے لیے تیار رہیں کہ آپ کی app ڈیٹا کیسے اور کب تبدیل کرتی ہے۔ غیر ضروری write permissions مسترد ہونے کی عام وجہ ہے۔