Stripe Statement Descriptor

Static, prefix and suffix

Stripe distinguishes three pieces. The static descriptor is the account default, set in the Dashboard under business details. Stripe says it "appears on all customer statements for non-card charges or payments."

For card payments there is also a shortened descriptor, or prefix, of between 2 and 10 characters. Each charge can add a dynamic suffix, and Stripe joins them with an asterisk and a space. Stripe's own example is a prefix of RUNCLUB and a suffix of OCT MARATHON, which produces RUNCLUB* OCT MARATHON. The whole result, separator included, must fit in 22 characters. If you set a static descriptor but no prefix, Stripe uses the static descriptor as the prefix for card payments and truncates it to 10 characters if it is longer.

The rules on the full text are strict. Stripe requires Latin characters only, at least one letter, none of the characters < > \ ' " or *, a reflection of your doing-business-as name, and more than a single common term or a bare website address unless that address clearly describes the transaction.

Which descriptor wins on an invoice or subscription

One-time payments are simple. For a non-card payment you can override the static descriptor on the PaymentIntent. For a card payment you cannot set the full descriptor at all: Stripe says you can only set the suffix.

Subscriptions are different, because Stripe creates those charges itself and you never touch the PaymentIntent. Stripe picks the descriptor in a fixed order. First, one set on the invoice. Second, one set on the product, and where a subscription has several items, Stripe uses the first item in the subscription's own item list that has a custom descriptor, not the first line on the invoice. Third, the account default for the charge type.

That order matters when a customer asks why a renewal looks different from their first payment. Changing the default in the Dashboard will not change a renewal whose product carries its own descriptor. Stripe also notes that finalized subscription invoices normally cannot be edited, so adding a descriptor to one means switching the subscription to send the invoice rather than charge automatically.

Why the customer-facing descriptor reaches your books

A descriptor the customer does not recognize is a dispute waiting to happen. Unrecognized is one of the dispute categories Stripe lists, covering cardholders who do not recognize a transaction. A dispute does not stay on the Stripe side: it takes money and a fee out of your balance, and the original sale in QuickBooks has to be corrected.

The cheapest fix is upstream. Make the descriptor match the name customers know you by, and use the suffix to say what was bought when you sell more than one thing. To check what a customer actually saw on a card payment, look at calculated_statement_descriptor on the charge. Stripe describes it as the full descriptor passed to card networks after the static and dynamic parts are combined.

The payout descriptor and your QuickBooks bank feed

Payouts are where the descriptor meets your own reconciliation. Stripe's API lets a payout you create carry a statement_descriptor of up to 22 characters, and anything longer returns an error. Stripe is candid about what happens next: "Most banks truncate this information and display it inconsistently. Some banks might not display it at all." For US ACH payouts, the descriptor maps to the ACH Company Entry Description field, which the NACHA standard limits to 10 characters, so Stripe truncates anything longer.

That has a practical consequence for QuickBooks. A bank rule can match only on Description, Bank text or Amount, so any rule written for Stripe payouts depends on whatever text your bank chose to show. With 10 characters at most on a US ACH payout, and some banks showing nothing, the descriptor is a weak thing to build a rule on. The payout amount and date are more reliable when you match a bank line to the payout record already in your books.

A descriptor you can control is still worth setting on payouts you create yourself. Something short and recognizable within the first 10 characters is the version that survives.