Skip to content
Sign in
An image of the Stripe logo
/
Create account
Sign in
Home
Payments
Finance automation
Banking as a service
Developer tools
No-code
All products
Home
Payments
Finance automation
Home
Payments
Finance automation
Banking as a service
Developer tools
Overview
Get started
About Stripe payments
Start an integration
Payment Links
Checkout
Web Elements
Mobile Elements
Payment scenarios
During the payment
    Email receipts
    Collect addresses
    Charge shipping
After the payment
Add payment methods
More payment scenarios
Faster checkout with Link
Other Stripe products
Connect
Terminal
Radar
Financial Connections
Crypto
Identity
Climate
Resources
About the APIs
Implementation guides
Regulation support
Testing
HomePayments

Collect physical addresses and phone numbers

Learn how to collect addresses and phone numbers during one-time payment flows.

Collect an address

To collect a customer’s billing address in a checkout session, pass the billing_address_collection parameter when you create a Checkout session. You have to specify whether to always collect the billing address (required) or only when it’s necessary (like for tax calculations) (auto).

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.

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.

Collect a phone number

To collect a customer’s phone number in a checkout session, pass the phone_number_collection parameter when you create a Checkout session.

See also

  • Add shipping rates
  • Collect taxes
Was this page helpful?
Need help? Contact Support.
Watch our developer tutorials.
Check out our product changelog.
Questions? Contact Sales.
Powered by Markdoc
You can unsubscribe at any time. Read our privacy policy.
Stripe Shell
Test mode
Welcome to the Stripe Shell! Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Log in to your Stripe account and press Control + Backtick (`) on your keyboard to start managing your Stripe resources in test mode. - View supported Stripe commands: - Find webhook events: - Listen for webhook events: - Call Stripe APIs: stripe [api resource] [operation] (e.g., )
The Stripe Shell is best experienced on desktop.
$