Collect physical addresses
Learn how to collect billing and shipping addresses.
You can collect billing and shipping addresses from your customers during checkout.
Collect a billing address
By default, a Checkout Session only collects a customer’s billing address when necessary (for example, to calculate tax). To always collect a billing address, set billing_address_collection to required when you create a Checkout Session.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
Collect a shipping address
To collect a customer’s shipping address in Checkout, pass the shipping_address_collection parameter when you create a Checkout Session. When you collect a shipping address, you must also specify which countries to allow shipping to. Configure the allowed_countries property with an array of two-letter ISO country codes.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
When the customer completes the session, the Checkout Session object saves the collected shipping address on the shipping_details property and includes it in the payload of the checkout.session.completed webhook. You can also see shipping information in the Dashboard on the payment details page.