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
| Processor | Length | Characters | Per-order text |
|---|---|---|---|
| Stripe | 5 to 22 total; prefix 2 to 10 | Latin only, at least one letter; no < > \ ' " * | Dynamic suffix on card payments: prefix + * + suffix, 22 max |
| PayPal | 22 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 Payments | 2 to 19 | Must include shop name, legal name, DBA name or URL | Not 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:
| Descriptor | Verdict | Why |
|---|---|---|
LMN HOLDINGS LLC | Bad | Legal entity name the buyer has never seen. |
ONLINE STORE | Bad | A common term; Stripe does not accept a single common term. |
LUMENCNDL | Weak | Abbreviated past recognition. |
LUMEN CANDLES | Good | The store name the buyer saw at checkout. |
LUMENCANDLES.COM | Good | The site they ordered from; easy to search. |
LUMEN* ORDER 4821 | Good | Stripe 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
- In the Dashboard, open the business details in your account settings and set the statement descriptor and the shortened descriptor (the prefix).
- For per-order text on card payments, pass
statement_descriptor_suffixon the PaymentIntent, orpayment_intent_data.statement_descriptor_suffixon a Checkout Session. - For subscriptions, you can't set it on the PaymentIntent. Set
statement_descriptoron the Product or the Invoice; Stripe uses the Invoice first, then the Product, then your default. - Fill in your support phone, email and website in the same public details. Stripe shows these on card statements or email receipts.
PayPal
- Go to Account Settings > Business information, click Update, then Edit, and change the credit card statement name. Avoid special characters such as
&,#and(). - For per-order text, send
soft_descriptorin the purchase unit when you create the order. Count the 8 characters ofPAYPAL *and your statement name first. - Buyers who paid by bank transfer see
PAYPALINST XFERinstead of your name, so put your store name in the receipt.
Shopify Payments
- In the Shopify admin, go to Settings > Payments and click Manage in the Shopify Payments section.
- 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.
14 days free, no card needed. Already have an account? Sign in
More guides
- Chargeback alerts: Ethoca, Verifi CDRN and Rapid Dispute Resolution
- Visa VAMP: the ratio, thresholds and fees for merchants
- Friendly fraud: what it is, how to spot it and how to win
- How to write a chargeback rebuttal letter
- How to respond to a Stripe dispute
- PayPal disputes for sellers: how to respond and win
- Chargeback time limits by card network
- Chargeback representment: what it is and how to win it
- Pre-arbitration chargebacks: what happens after your first response
- Chargeback vs refund: what's the difference for merchants?
- Chargeback fees: who pays and how much
- Visa Compelling Evidence 3.0: how CE 3.0 works for fraud disputes
- Customer service email templates for online stores
- How does a chargeback work? The process from dispute to decision
- American Express chargebacks: how inquiries and disputes work
- PayPal chargebacks: what happens when the buyer goes to their bank
- Shopify chargebacks: how to respond and what Shopify does for you
- PayPal Seller Protection: what it covers and how to qualify
- Credit card decline codes: what each one means and when to retry
- Ecommerce customer service: a playbook that also prevents chargebacks