Payout statement descriptors
Understand and manage how Stripe payouts look on a connected account's bank statements.
The statement descriptor used for Connect payouts varies according to the properties of the connected account and the conditions of the payout. There is a precedence order used for manual and automatic payouts.
Connected accounts can have a customised statement descriptor stored on the Account object at settings.payout.statement_descriptor.
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_
OAuth scope. Connected accounts can use thewrite read_
OAuth scope if they have access to the Stripe Dashboard and aren’t explicitly restricted from using it with platform controls.write
Unless all 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.
Precedence order
The precedence order for the statement descriptor is different for manual and automatic payouts.
Manual payouts
- The statement_descriptor set on the Payout object.
- The settings.payout.statement_descriptor from the connected account, if your platform and the connected account were created on or after 9 October 2023.
- Your platform’s default statement descriptor, if it’s applicable to the connected account.
- If no other conditions are met, the statement descriptor might default to STRIPE.
Automatic payouts
- The settings.payout.statement_descriptor from the connected account, if your platform and the connected account were created on or after 9 October 2023.
- Your platform’s default statement descriptor, if it’s applicable to the connected account.
- If no other conditions are met, the statement descriptor might default to STRIPE.