Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Get started with Connect
Integration fundamentals
Example integrations
Onboard accounts
Configure account Dashboards
Accept payments
Pay out to accounts
    Payouts to connected accounts
    Manage payout accounts for connected accounts
    Manage payout schedule
    Manual payouts
    Payout reversals
    Payout statement descriptors
    Multi-currency settlement
    Instant Payouts
    Cross-border payouts
    Stablecoin payouts
Manage your Connect platform
Tax forms for your Connect platform
Work with connected account types
HomePlatforms and marketplacesPay out to accounts

Payout statement descriptors

Understand and manage how Stripe payouts appear on a connected account's bank statements.

Copy page

The statement descriptor used for Connect payouts varies according to the properties of the connected account and the conditions of the payout. We use a precedence order for manual and automatic payouts.

Connected accounts can have a customized statement descriptor stored on the Account object at settings.payout.statement_descriptor.

Banks can override your statement descriptor

Beneficiary banks don’t guarantee that they’ll display statement descriptors. While Stripe shares this information with the beneficiary’s bank, it’s up to the beneficiary bank to decide what they actually display on the bank statement.

Default statement descriptor

Connect platforms can configure a platform-wide default statement descriptor in their Connect settings, which is also used under certain criteria. Even when the precedence order falls to it, the default statement descriptor configured in your platform’s Connect settings only applies to a connected account’s payout under certain criteria.

  • The connected account belongs to a platform that pays Stripe fees (including Custom and Express accounts), or you have platform controls for it.
  • The connected account doesn’t have access to the Stripe API. Connected accounts only have access to the Stripe API if they can access the Stripe Dashboard.
  • The connected account isn’t restricted from using the read_write OAuth scope. Connected accounts can use the read_write OAuth scope if they have access to the Stripe Dashboard and aren’t explicitly restricted from using it with platform controls.

Unless all of these criteria apply, the statement descriptor defaults to STRIPE. However, this default might be subject to other external factors, such as which bank processed the payout.

Dashboard

You can customize a statement descriptor for all your connected accounts payouts on your connect settings page in the Dashboard.

API

Command Line
cURL
curl https://api.stripe.com/v1/accounts/
{{ACCOUNT_ID}}
\ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d "settings[payouts][statement_descriptor]"="Cactus Payouts"
Example response of an account updates with a Payout Statement Descriptor
{ "id": "{{ACCOUNT_ID}}", "object": "account", ... "settings": { "payouts": { "statement_descriptor": "Cactus Payouts" } } }

Precedence order

If you don’t define any statement descriptor for your connected accounts, we default to STRIPE as the descriptor shown on your connected account’s bank statement.

Platform Statement Descriptor precedence

To learn more about account-level and payout-level statement descriptors, visit the payout statement descriptors overview page.

Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc