Sign in
An image of the Stripe logo
Create account
Sign in
Home
Payments
Business operations
Financial services
Developer tools
Security
All products
Home
Payments
Business operations
Home
Payments
Business operations
Financial services
Developer tools
Support
Overview
Overview
How invoicing works
Get started
No-code quickstart guide
Payment methods
Invoicing resources
Customers
Customer credit balance
Customer tax IDs
Products and prices
Taxes
Manage invoices
Use the Dashboard
Integrate with the API
Customize invoices
Send customer emails
Hosted Invoice Page
Invoicing and Connect
Automated collections
Automatic reconciliation
Automatic collection
Automatic charging
Global invoicing
Set up invoices in Europe
Multiple currencies
Testing
No-code options
invoicing
·
HomePaymentsInvoicing

Customers

Learn how to use the Customer resource with Stripe Invoicing.

Create a customer for every new user or business you want to bill. When you create a new customer, set up a minimal customer profile to help generate more useful invoices, and enable Smart Retries (if you’re an Invoicing Plus user). After you set up your customer, you can issue one-off invoices or create subscriptions.

You can create and manage customers on the Customers page when you don’t want to use code to create a customer, or if you want to manually bill a customer with a one-off invoice.

You can also create a customer in the Dashboard during invoice creation.

Create a customer

When you create a new customer, you can set their account and billing information, such as Email, Name, and Country. You can also set a customer’s preferred language, currency, and other important details.

Customers page

You can also perform these actions on the Customers page:

  • Filter your customers.
  • Delete customers.
  • View all of your customers.
  • Export a list of customer data.

To create a customer, complete these steps:

  1. Click Add customer, or press N, on the Customers page.

  2. At a minimum, enter your customer’s Name and Account email.

  3. Click Add customer in the dialog.

Edit a customer

To edit a customer’s profile, complete these steps:

  1. Find the customer you want to modify and click the name on the Customers page.

  2. In the account information page, select Actions > Edit information.

  3. Make your changes to the customer profile.

  4. Click Update customer.

Delete a customer

To delete a customer, complete these steps:

  1. Find the customer you want to delete on the Customers page.

  2. Click the checkbox next to your customer’s name followed by Delete. You can also click into the customer’s details page and select Actions > Delete customer.

Customer profiles

​​Use a basic customer profile for invoice and receipt generation or as a lightweight customer relationship management system (CRM) for your application. To create a minimal customer profile, set these properties:

  • Email address.
  • Customer name.
  • Metadata with a reference to your application’s internal customer ID.

Stripe uses your customer’s email address to notify them of payment failures. Stripe also uses email addresses to notify customers when they need to perform an action to complete a payment.

Store the internal customer ID for your application in the metadata attribute. Like most Stripe resources, the Customer resource includes a Metadata object hash to flexibly store contextual key-value information. To aid in auditing and support, store your internal customer ID as a key-value pair on the Customer resource. This allows you to search for the customer using your internal reference ID. We recommend storing Stripe customer IDs against the internal customer model of your application.

Billing and shipping addresses

Use the address attributes to set a billing address for invoicing and credit notes. For physical good delivery, add a shipping address.

Invoices, credit notes, and receipts display the billing address—a common requirement for tax compliance.

Email and PDF language localization

When you create a customer, use the Language dropdown to add their preferred language. (You can also add or edit a customer’s preferred language in the Customer details page or when creating an invoice.) Stripe uses the chosen language to localize invoice emails and PDFs, receipt emails and PDFs, and credit note PDFs.

To update the language through the API, use the preferred_locales parameter. This parameter accepts an ordered list of preferred languages sorted by preference. These preferred locale values are based on RFC-4646. Examples include en for English, or fr-CA for Canadian French. To learn more, see Customer preferred languages.

Customer properties

The following table contains additional customer properties:

Property
Description
Payment propertiesStripe uses the payment details associated with a customer to collect payment. A customer can have multiple ways to make a payment, including the Payment Methods API and Customer credit balance. Customers are single-currency, which means that after you assign a currency, invoice the customer, or set a customer credit balance, you can’t change the currency. You can see this locked state in the Dashboard in a disabled Currency dropdown. If you need to bill a single entity with multiple currencies, create a new customer for each currency.
Invoicing propertiesAll invoicing-related resources are associated with the billed customer.
Tax propertiesTo meet tax jurisdiction requirements, you might need to include customer tax ID numbers and other tax-related information on your invoices. ​​It’s your responsibility to make sure your customer’s invoices contain all of the correct information, such as tax IDs, tax exemption status, and addresses. Tax IDs provide a way to store and render one or more tax ID numbers on invoices. The tax exemption status indicates whether the entity is taxable. By default, a customer’s tax_exempt status is set to none—meaning it’s a taxable billing entity. However, you can set the tax_exempt parameter to reverse for customers that must pay the invoice’s tax. You can also flag the customer as being tax exempt by setting the status to exempt. To learn more about using tax_exempt and reverse, see Tax Rates.

Common tasks

Here are some of the common tasks you can perform with the Customer resource:

  • Sending an invoice to a customer—After you create the customer, you can send them an invoice.

  • Storing a customer credit balance—The customer credit balance feature allows you to assign credit and debit adjustments to a specific customer and then apply the resulting balance toward future invoices for them.

  • Adding and validating tax ID numbers—Displaying a customer’s tax ID on an invoice is a common requirement, and Stripe allows you to add multiple tax IDs to a customer. Their tax IDs display in the header of invoice and credit note PDFs. See the Customer tax IDs page for more details.

  • Adding a coupon to a customer—A coupon contains information about a percent-off or amount-off discount, and Stripe Invoicing allows you to associate a coupon with a customer. Coupons apply a discount to the invoice amount due, on a pre-tax basis.

  • Setting the currency for a customer—The currency parameter is a three-letter ISO currency code ​​that you can apply to your customer. You can set the customer’s currency with the API by passing a valid ISO code. You can also use the Dashboard to set the currency by navigating to the Customers page, selecting your customer, and clicking Edit next to Details.

Was this page helpful?
Questions? Contact us.
View developer tutorials on YouTube.
Check out our product changelog.
Powered by Markdoc
You can unsubscribe at any time. Read our privacy policy.
On this page
Customer profiles
Customer properties
Common tasks
Stripe Shell
Test mode
▗▄ ▄▟█ █▀▀ ▗▟████▙▖ ██████ ███▗▟█ ███ ███▗▟██▙▖ ▗▟█████▙▖ ███▖ ▀▀ ███ ███▀▀▀ ███ ███▀ ███ ███ ███ ▝▜████▙▖ ███ ███ ███ ███ ███ █████████ ▄▄ ▝███ ███ ▄ ███ ███ ███▄ ███ ███ ▄▄ ▝▜████▛▘ ▝▜███▛ ███ ███ ███▝▜██▛▘ ▝▜█████▛▘ ███ ▀▘
Welcome to the Stripe Shell! This is a graphical user interface of the Stripe CLI. You can use it to discover webhook events and manage your Stripe resources. By pressing ctrl + ` you can toggle it open from any page within the Stripe documentation. - View supported commands: - Listen for webhook events: - Trigger webhook events: - Call Stripe APIs: stripe [api resource] [api operation] (e.g. )
The Stripe Shell is best experienced on desktop.
$