A billing descriptor is the name a buyer sees next to your charge on their card statement. It is also called a merchant descriptor, statement descriptor or payment descriptor. You get about 22 characters, and if those characters do not match the store the buyer remembers, some of them will call their bank instead of you. This guide covers the length and character rules on Stripe, PayPal and Shopify Payments, good and bad examples, and where to change it.

Why an unclear descriptor turns into a dispute

A buyer who sees a charge they do not recognize has two choices: search for it, or ask the bank. The bank route ends in a dispute. Stripe's own documentation says clear statement descriptors can reduce chargebacks and disputes, and that if a customer can't recognize a payment, they might dispute it. These disputes show up as fraud or "unrecognized" claims, such as Mastercard4863, Cardholder Does Not Recognize, or Visa10.4, card-absent fraud. Stripe also notes that general or duplicate disputes can point to an unrecognized descriptor.

These disputes are winnable, because you did make the sale, but every one still costs a dispute fee and counts toward your dispute ratio, won or lost. A clearer descriptor prevents them for free. Some American Express and Discover cases start as aninquiry first, and Stripe says that is often because the cardholder does not recognize the transaction description.

Descriptor rules by processor

ProcessorLengthCharactersPer-order text
Stripe5 to 22 total; prefix 2 to 10Latin only, at least one letter; no < > \ ' " *Dynamic suffix on card payments: prefix + * + suffix, 22 max
PayPal22 shown on the statement, including PAYPAL * (8)Soft descriptor: letters, digits, dashes, asterisks, periods, spaces. Statement name: avoid &, #, ()soft_descriptor on the order, truncated after 22
Shopify Payments2 to 19Must include shop name, legal name, DBA name or URLNot offered; plus a required phone number

Stripe: static descriptor, prefix and dynamic suffix

Stripe's rules for a complete descriptor: Latin characters only, 5 to 22 characters, at least one letter, none of < > \ ' " *, it must reflect your Doing Business As name, and it must be more than a single common word or a common website URL. A URL alone is fine only when it clearly describes the charge.

For card payments you can split it into a static prefix (Stripe's Dashboard calls it the shortened descriptor, 2 to 10 characters) and a dynamic suffix per payment. Stripe joins them as the prefix, an asterisk and a space, then the suffix, and the whole thing must fit in 22 characters. Stripe's example: prefixRUNCLUB plus suffix OCT MARATHON becomes RUNCLUB* OCT MARATHON. If you set only a static descriptor, Stripe uses it as the prefix for card payments and cuts it to 10 characters, so check what your shortened version looks like.

PayPal: soft descriptor and statement name

On payments through a PayPal wallet, PayPal builds the line as PAYPAL *, then the descriptor from your account settings, then thesoft_descriptor you send with the order. Only the first 22 characters are shown. PayPal's own example: merchant descriptor Janes Giftand soft descriptor 800-123-1234 appear as PAYPAL * Janes Gift 80. The phone number is cut off almost entirely, so a long account name leaves no room for anything else.

Shopify Payments: customer statement name

Shopify requires the name to be 2 to 19 characters and to include your shop name, legal name, DBA name or URL. If you do not set one, or yours does not meet the rules, Shopify sets one and emails the account owner. Shopify also asks for a phone number in the same section so customers can reach you about a charge.

Good and bad descriptors

The test is simple: would a buyer who ordered from your website three weeks ago recognize this line? These examples are illustrative, for a store called Lumen Candles:

DescriptorVerdictWhy
LMN HOLDINGS LLCBadLegal entity name the buyer has never seen.
ONLINE STOREBadA common term; Stripe does not accept a single common term.
LUMENCNDLWeakAbbreviated past recognition.
LUMEN CANDLESGoodThe store name the buyer saw at checkout.
LUMENCANDLES.COMGoodThe site they ordered from; easy to search.
LUMEN* ORDER 4821GoodStripe prefix plus a suffix that matches the order number in the receipt.

If you sell under one brand but bill under another (a parent company, a marketplace, a platform), close the gap: use the brand in the descriptor, and say in the order confirmation email exactly what the statement will show.

How to set your billing descriptor

Stripe

  1. In the Dashboard, open the business details in your account settings and set the statement descriptor and the shortened descriptor (the prefix).
  2. For per-order text on card payments, pass statement_descriptor_suffix on the PaymentIntent, or payment_intent_data.statement_descriptor_suffix on a Checkout Session.
  3. For subscriptions, you can't set it on the PaymentIntent. Set statement_descriptor on the Product or the Invoice; Stripe uses the Invoice first, then the Product, then your default.
  4. Fill in your support phone, email and website in the same public details. Stripe shows these on card statements or email receipts.

PayPal

  1. Go to Account Settings > Business information, click Update, then Edit, and change the credit card statement name. Avoid special characters such as &, # and ().
  2. For per-order text, send soft_descriptor in the purchase unit when you create the order. Count the 8 characters of PAYPAL * and your statement name first.
  3. Buyers who paid by bank transfer see PAYPALINST XFER instead of your name, so put your store name in the receipt.

Shopify Payments

  1. In the Shopify admin, go to Settings > Payments and click Manage in the Shopify Payments section.
  2. In Customer billing statement, enter the statement name and a phone number, then save.

Adding a phone number or URL

A phone number or website gives a confused buyer a way to reach you before they reach their bank. Shopify Payments collects a phone number for this purpose; Stripe sends your support details as part of your public business information; and PayPal's example shows a phone number in the soft descriptor, although the 22 character limit truncates it. A short domain name often works better than a phone number because it is both your brand and a way to find you. Either way, banks decide the final layout: Stripe says some banks display the descriptor incorrectly or not at all, and Shopify says extra details are up to the individual bank.

Before you change it

  • Keep one static prefix. Stripe says Visa identifies a merchant by the static part of the descriptor and the acquiring bank, so several descriptors can become several Visa accounts in the VAMP program. Stripe recommends one shared prefix and changing it at the end of a month.
  • Match the receipt. Put the descriptor text and the order number in the confirmation email, so the buyer can match the two.
  • Answer the "what is this charge" email fast. When a buyer writes in about an unknown charge, a quick reply with the order details can end it there. Ahelpdesk that shows the order next to the message makes that quick, and the reply becomes evidence if they dispute anyway. Thecustomer service email templates include one for this.

Questions

What is a billing descriptor?

The short text that appears next to a charge on the buyer's card or bank statement. Stripe calls it a statement descriptor, PayPal calls the per-order part a soft descriptor, and Shopify calls it the customer statement name. Merchant descriptor and payment descriptor mean the same thing.

How long can a billing descriptor be?

On Stripe, 5 to 22 characters in total, with a prefix of 2 to 10 characters if you use a dynamic suffix. On PayPal, the statement shows at most 22 characters, and the PAYPAL * prefix uses 8 of them. On Shopify Payments, the statement name is 2 to 19 characters.

Can I put a phone number or website in my descriptor?

Yes, if it fits. PayPal's own API example puts a phone number in the soft descriptor, and Shopify Payments asks for a phone number next to the statement name. Stripe accepts a website URL on its own only when it clearly describes the charge. Banks decide what they actually display.

Does changing my descriptor affect my dispute ratio?

It can. Stripe says Visa identifies merchant accounts by the static part of the statement descriptor, so several descriptors can count as several Visa accounts. Stripe recommends giving them the same static prefix, and making changes at the end of a month.

Why do customers dispute charges they made?

Often because they do not recognize the name on their statement. Stripe says an unclear descriptor can lead to disputes, and Mastercard has a reason code, 4863, for a cardholder who does not recognize a transaction.

Sources: Stripe Statement descriptors,Set up your account,How disputes work andMonitoring programs; PayPalOrders API v2 (soft_descriptor) andstatement name help; Shopify Configuring Shopify Payments. Checked October 29, 2026.

Keep the evidence before you need it

Rebutdesk is an open-source helpdesk where Stripe and PayPal disputes open inside the buyer's support case, so the conversation, refunds and shipping events are already in order when the deadline starts. See how it works.

Start free trial

14 days free, no card needed. Already have an account? Sign in

More guides