अनुमतियों की संदर्भ सूची
Stripe Apps एक अनुमति प्रणाली का इस्तेमाल करते हैं, जिससे Stripe API संसाधनों तक पहुँच नियंत्रित होती है. हर अनुमति को आपके ऐप मैनिफ़ेस्ट में साफ़ उद्देश्य विवरण के साथ स्पष्ट रूप से घोषित करना ज़रूरी है. जब उपयोगकर्ता आपका ऐप इंस्टॉल करते हैं, तब वे इन अनुमतियों को मंज़ूरी देते हैं.
Caution
स्थिति: नियोजित, अभी बना नहीं. Tajo के पास कोई Stripe App नहीं है, इसलिए इस सेक्शन में से आज कुछ भी इंस्टॉल नहीं किया जा सकता. इस पेज पर दिए गए ऐप आइडेंटिफ़ायर, URL और क्रेडेंशियल उदाहरण के लिए रखे गए प्लेसहोल्डर हैं, लाइव एंडपॉइंट नहीं.
अनुमतियाँ मैनेज करना
अनुमतियाँ घोषित करना
अपने 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 से अनुमतियाँ दे सकते हैं:
# 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 "Read Stripe events"अनुमतियों के लिए सर्वोत्तम तरीके
- ज़रूरत भर की अनुमतियाँ: सिर्फ़ वही अनुमतियाँ मांगें जिनका आपका ऐप वाकई इस्तेमाल करता है
- साफ़ उद्देश्य: उद्देश्य विवरण ऐसे लिखें जो ग़ैर-तकनीकी उपयोगकर्ता भी समझ सकें
- read+write का औचित्य दें: अगर आपको read और write दोनों चाहिए, तो हर उद्देश्य में इसकी वजह बताएं
- नियमित समीक्षा करें: ऐप अपडेट करते समय उन अनुमतियों को हटा दें जिनकी अब ज़रूरत नहीं है
Tip
ज़रूरत से ज़्यादा अनुमतियाँ मांगना ऐप अस्वीकार होने के सबसे आम कारणों में से एक है. सिर्फ़ वही मांगें जिसकी आपको ज़रूरत है.
प्रोडक्ट के अनुसार अनुमतियाँ
कोर
| संसाधन | अनुमति | विवरण |
|---|---|---|
| Account | account_read | अकाउंट का विवरण और सेटिंग्स पढ़ें |
| Account | account_write | अकाउंट सेटिंग्स अपडेट करें |
| Balance | balance_read | अकाउंट बैलेंस और ट्रांज़ैक्शन देखें |
| Customer | customer_read | ग्राहक प्रोफ़ाइल, मेटाडेटा और भुगतान विधियाँ पढ़ें |
| Customer | customer_write | ग्राहक रिकॉर्ड बनाएं, अपडेट करें या हटाएं |
| Event | event_read | अकाउंट इवेंट पढ़ें और उन्हें सब्सक्राइब करें |
| File | file_read | अपलोड की गई फ़ाइलें और फ़ाइल लिंक पढ़ें |
| File | file_write | फ़ाइलें अपलोड करें और फ़ाइल लिंक बनाएं |
| Mandate | mandate_read | भुगतान मैंडेट पढ़ें |
| Product | product_read | प्रोडक्ट कैटलॉग और कीमतें पढ़ें |
| Product | product_write | प्रोडक्ट और कीमतें बनाएं, अपडेट करें या हटाएं |
| Token | token_read | टोकनाइज़ किया गया भुगतान डेटा पढ़ें |
| Webhook Endpoint | webhook_endpoint_read | webhook endpoint कॉन्फ़िगरेशन पढ़ें |
| Webhook Endpoint | webhook_endpoint_write | webhook endpoint बनाएं, अपडेट करें या हटाएं |
भुगतान
| संसाधन | अनुमति | विवरण |
|---|---|---|
| Charge | charge_read | भुगतान चार्ज और रिफ़ंड पढ़ें |
| Charge | charge_write | चार्ज बनाएं, भुगतान कैप्चर करें, रिफ़ंड जारी करें |
| Dispute | dispute_read | भुगतान विवाद और सबूत पढ़ें |
| Dispute | dispute_write | विवाद के सबूत जमा करें और विवादों का जवाब दें |
| Payment Intent | payment_intent_read | payment intent का विवरण और स्थिति पढ़ें |
| Payment Intent | payment_intent_write | payment intent बनाएं, कन्फ़र्म करें या कैंसल करें |
| Payment Method | payment_method_read | सहेजी गई भुगतान विधियाँ पढ़ें |
| Payment Method | payment_method_write | ग्राहकों से भुगतान विधियाँ जोड़ें या हटाएं |
| Payout | payout_read | पेआउट का विवरण और शेड्यूल पढ़ें |
| Payout | payout_write | पेआउट बनाएं या कैंसल करें |
| Refund | refund_read | रिफ़ंड का विवरण पढ़ें |
| Refund | refund_write | रिफ़ंड बनाएं या अपडेट करें |
| Setup Intent | setup_intent_read | setup intent का विवरण पढ़ें |
| Setup Intent | setup_intent_write | setup intent बनाएं या कन्फ़र्म करें |
बिलिंग
| संसाधन | अनुमति | विवरण |
|---|---|---|
| Coupon | coupon_read | डिस्काउंट कूपन और प्रोमोशन कोड पढ़ें |
| Coupon | coupon_write | कूपन बनाएं, अपडेट करें या हटाएं |
| Credit Note | credit_note_read | क्रेडिट नोट पढ़ें |
| Credit Note | credit_note_write | क्रेडिट नोट बनाएं या रद्द करें |
| Invoice | invoice_read | इनवॉइस का विवरण, लाइन आइटम और स्थिति पढ़ें |
| Invoice | invoice_write | इनवॉइस बनाएं, अपडेट करें, फ़ाइनल करें या रद्द करें |
| Invoice Item | invoice_item_read | लंबित इनवॉइस आइटम पढ़ें |
| Invoice Item | invoice_item_write | इनवॉइस आइटम बनाएं या हटाएं |
| Plan | plan_read | सब्सक्रिप्शन प्लान और कीमतें पढ़ें |
| Plan | plan_write | प्लान बनाएं, अपडेट करें या हटाएं |
| Price | price_read | कीमत कॉन्फ़िगरेशन पढ़ें |
| Price | price_write | कीमतें बनाएं या अपडेट करें |
| Quote | quote_read | कीमत के कोटेशन पढ़ें |
| Quote | quote_write | कोटेशन बनाएं, फ़ाइनल करें या स्वीकार करें |
| Subscription | subscription_read | सब्सक्रिप्शन का विवरण, शेड्यूल और स्थिति पढ़ें |
| Subscription | subscription_write | सब्सक्रिप्शन बनाएं, अपडेट करें या कैंसल करें |
| Subscription Schedule | subscription_schedule_read | सब्सक्रिप्शन शेड्यूल पढ़ें |
| Subscription Schedule | subscription_schedule_write | सब्सक्रिप्शन शेड्यूल बनाएं, अपडेट करें या रिलीज़ करें |
| Usage Record | usage_record_read | मीटर्ड बिलिंग के उपयोग रिकॉर्ड पढ़ें |
| Usage Record | usage_record_write | मीटर्ड बिलिंग के लिए उपयोग रिकॉर्ड बनाएं |
चेकआउट
| संसाधन | अनुमति | विवरण |
|---|---|---|
| Checkout Session | checkout_session_read | Checkout Session का विवरण और लाइन आइटम पढ़ें |
| Checkout Session | checkout_session_write | Checkout Session बनाएं या समाप्त करें |
| Payment Link | payment_link_read | Payment Link कॉन्फ़िगरेशन पढ़ें |
| Payment Link | payment_link_write | Payment Link बनाएं या अपडेट करें |
Connect
| संसाधन | अनुमति | विवरण |
|---|---|---|
| Application Fee | application_fee_read | ऐप्लिकेशन फ़ीस का विवरण पढ़ें |
| Connected Account | connected_account_read | कनेक्टेड अकाउंट का विवरण पढ़ें |
| Connected Account | connected_account_write | कनेक्टेड अकाउंट बनाएं या अपडेट करें |
| Transfer | transfer_read | अकाउंट के बीच ट्रांसफ़र का विवरण पढ़ें |
| Transfer | transfer_write | कनेक्टेड अकाउंट में ट्रांसफ़र करें |
| Top-up | topup_read | टॉप-अप का विवरण पढ़ें |
| Top-up | topup_write | Stripe बैलेंस में टॉप-अप करें |
Issuing
| संसाधन | अनुमति | विवरण |
|---|---|---|
| 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 विवाद बनाएं या जमा करें |
रिपोर्टिंग
| संसाधन | अनुमति | विवरण |
|---|---|---|
| Report Run | report_run_read | रिपोर्ट रन के नतीजे पढ़ें |
| Report Run | report_run_write | नए रिपोर्ट रन बनाएं |
| Report Type | report_type_read | उपलब्ध रिपोर्ट प्रकार पढ़ें |
टैक्स
| संसाधन | अनुमति | विवरण |
|---|---|---|
| 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 Reader | terminal_reader_read | टर्मिनल रीडर का विवरण पढ़ें |
| Terminal Reader | terminal_reader_write | टर्मिनल रीडर रजिस्टर या अपडेट करें |
| Terminal Location | terminal_location_read | टर्मिनल लोकेशन का विवरण पढ़ें |
| Terminal Location | terminal_location_write | टर्मिनल लोकेशन बनाएं या अपडेट करें |
Secret Store
| संसाधन | अनुमति | विवरण |
|---|---|---|
| Secret | secret_read | Secret Store से सीक्रेट पढ़ें |
| Secret | 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": "Read 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 to deliver events to Tajo" } ]}अनुमति के दायरे
अनुमतियाँ अलग-अलग दायरों में काम कर सकती हैं, यह इस पर निर्भर करता है कि आपका ऐप प्लेटफ़ॉर्म अकाउंट पर इंस्टॉल है या किसी कनेक्टेड अकाउंट पर:
| दायरा | विवरण |
|---|---|
| Account | अनुमतियाँ इंस्टॉल करने वाले अकाउंट के अपने डेटा पर लागू होती हैं |
| Connected Account | Connect प्लेटफ़ॉर्म के लिए अनुमतियाँ कनेक्टेड अकाउंट तक भी बढ़ सकती हैं |
Caution
write अनुमतियाँ मांगते समय ऐप समीक्षा के दौरान यह ठीक-ठीक बताने के लिए तैयार रहें कि आपका ऐप डेटा को कैसे और कब बदलता है. ग़ैर-ज़रूरी write अनुमतियाँ अस्वीकार होने का एक आम कारण हैं.