Request permissionsBeta

Learn how to request permissions for your application to access the Stripe API.

Application developers can request permissions for their applications. These permissions grant granular access to the Stripe API.

Resource	Permission	Description
Account	`connected_account_read`	Grants access to read Accounts
Account link	`account_link_write`	Grants access to Account Links
Apple Pay Domain	`apple_pay_domain_read`, `apple_pay_domain_write`	Grants access to Apple Pay Domain resources. To use Apple Pay, you need to register your web domains with Apple. See domain registration for more information.
Application Fee	`application_fee_read`, `application_fee_write`	Grants access to Application Fees
Balance	`balance_read`	Grants access to Balance
Balance transaction source	`balance_transaction_source_read`	Grants access to expand the `source` attribute when retrieving Balance Transactions This permission also implies the following permissions: `application_fee_read`, `balance_read`, `transfer_read`
Billing clock	`billing_clock_read`, `billing_clock_write`	Grants access to Test clocks
Charge	`charge_read`, `charge_write`	Grants access to Charges
Checkout Session	`checkout_session_read`, `checkout_session_write`	Grants access to Sessions This permission also implies the following permissions: `mandate_read`, `payment_intent_read`, `payment_links_read`, `product_read`, `setup_intent_read`, `sku_read`
Configuration	`terminal_configuration_read`, `terminal_configuration_write`	Grants access to Configurations
Connection Token	`terminal_connection_token_write`	Grants access to Connection Tokens
Coupon	`coupon_read`, `coupon_write`	Grants access to Coupons
Credit note	`credit_note_read`, `credit_note_write`	Grants access to Credit Notes This permission also implies the following permissions: `invoice_read`,
Customer portal	`customer_portal_read`, `customer_portal_write`	Grants access to the customer portal If you’re using the customer portal to manage subscriptions or payment methods, you must also request `elements_write`.
Customer	`customer_read`, `customer_write`	Grants access to Customers This permission also implies the following permission: `billing_clock_read`.
Dispute	`dispute_read`, `dispute_write`	Grants access to Disputes
Edit link	`edit_link_write`	Grants access to Login Links
Elements	`elements_write`	Grants access to Stripe.js Elements
Event	`event_read`	Grants access to Events
File	`file_read`, `file_write`	Grants access to Files
Invoice	`invoice_read`, `invoice_write`	Grants access to Invoices This permission also implies the following permission: `credit_note_read` If you’re using the hosted invoice page to manage invoices or payment methods, you must also request `elements_write`.
Issuing authorization	`issuing_authorization_read`, `issuing_authorization_write`	Grants access to Authorizations
Issuing card	`issuing_card_read`, `issuing_card_write`	Grants access to Cards
Issuing cardholder	`issuing_cardholder_read`, `issuing_cardholder_write`	Grants access to Cardholders
Issuing dispute	`issuing_dispute_read`, `issuing_dispute_write`	Grants access to Issuing Disputes
Issuing transaction	`issuing_transaction_read, issuing_transaction_write`	Grants access to Transactions
Location	`terminal_location_read`, `terminal_location_write`	Grants access to Locations
Mandate	`mandate_read`, `mandate_write`	Grants access to Mandates
Order	`order_read`, `order_write`	Grants access to Orders
Payment intent	`payment_intent_read`, `payment_intent_write`	Grants access to PaymentIntents If you’re managing PaymentIntents with Stripe.js Elements, you must also request `elements_write`. This permission also implies the following permissions: `product_read`, `sku_read`
Payment links	`payment_links_read`, `payment_links_write`	Grants access to Payment Links This permission also implies the following permissions: `mandate_read`, `product_read`, `sku_read`
Payment method	`payment_method_read`, `payment_method_write`	Grants access to PaymentMethods This permission also implies the following permission: `source_read`
Payout	`payout_read`, `payout_write`	Grants access to Payouts
Plan	`plan_read`, `plan_write`	Grants access to Plans and Prices
Product	`product_read`, `product_write`	Grants access to Products
Promotion Code	`promotion_code_read`, `promotion_code_write`	Grants access to Promotion Codes
Quote	`quote_read`, `quote_write`	Grants access to Quotes This permission also implies the following permissions: `sku_read`, `product_read`
Reader	`terminal_reader_read`, `terminal_reader_write`	Grants access to Readers
Report Runs and Report Types	`report_runs_and_report_types_read`	Grants read access to Report Types and allows creation of Report Runs
Review	`review_read`, `review_write`	Grants access to Reviews
Secret	`secret_write`	Grants access to Secrets
Setup Intent	`setup_intent_read`, `setup_intent_write`	Grants access to SetupIntents If you’re managing SetupIntents with Stripe.js Elements, you must also request `elements_write`. This permission also implies the following permission: `mandate_read`
Shipping rate	`shipping_rate_read`, `shipping_rate_write`	Grants access to Shipping Rates
SKU	`sku_read`, `sku_write`	Grants access to SKUs
Source	`source_read`, `source_write`	Grants access to Sources
Subscription	`subscription_read`, `subscription_write`	Grants access to Subscriptions
Tax rate	`tax_rate_read`, `tax_rate_write`	Grants access to Tax Rates
Tax settings	`tax_settings_read`, `tax_settings_write`,	Grants access to Tax Settings
Tax transaction	`tax_calculations_and_transactions_read`, `tax_calculations_and_transactions_write`,	Grants access to Tax Calculations and Transactions
Token	`token_read`, `token_write`	Grants access to Tokens
Top up	`top_up_read`, `top_up_write`	Grants access to Top-ups
Transfer	`transfer_read`, `transfer_write`	Grants access to Transfers This permission also implies the following permission: `payout_read`, `payout_write`
Usage record	`usage_record_read`, `usage_record_write`	Grants access to Usage Records
User Email	`user_email_read`	Grants access to user emails
Webhook	`webhook_read`, `webhook_write`	Grants access to Webhook Endpoints For most apps, you don’t need to include`webhook_write`. Instead, setup a webhook to listen to events from your connected accounts. If you feel that you still need `webhook_write`, please contact Stripe Support.