Billing address collection is important for:

Payment verification and fraud prevention
Tax calculation for digital goods and services
Compliance with payment processor requirements
Address Verification Service (AVS) checks

The platform provides multiple ways to collect billing addresses, allowing you to choose the method that best fits your checkout flow.

Express Checkout & Payment Request Button Configuration

Collect billing address

This property controls how billing addresses are collected for Apple Pay and Google Pay buttons (Express Checkout Element and Payment Request Button).

Available Options:

"Don't collect billing address" (default)
- No address collection
- Minimal friction for users
- Suitable when billing address is not required
"Collect billing address from wallet"
- Prompts users to provide shipping address through Apple Pay/Google Pay
- The shipping address is used as the billing address
- Shows "Free shipping" for digital products
- Address data is sent to Stripe with the payment method
"Don't request address, fill from IP"
- No user prompt for address
- Automatically fills address based on IP geolocation
- Uses data from IP location service:
  - City name
  - State/Province
  - Postal/ZIP code
  - Country code
- Reduces checkout friction while still providing address data

Stripe Form Configuration

Auto-fill billing address

This property controls automatic billing address filling for the standard Stripe payment form.

Available Options:

"Don't auto-fill billing address" (default)
- Standard behavior
- No automatic address filling
- Users must enter address manually if required
"Auto-fill billing address from IP location"
- Automatically includes billing address in payment confirmation
- Uses IP-based geolocation data
- Address is attached to the payment method in Stripe

How It Works

Express Checkout / Payment Request Flow

When "Collect billing address from wallet" is selected:
- User clicks Apple Pay/Google Pay button
- Wallet interface shows shipping address selection
- Selected address is passed as billing address to Stripe
- Address is saved on the payment method
When "Don't request address, fill from IP" is selected:
- User clicks payment button
- No address prompt shown
- System automatically uses IP geolocation data
- Address is included in payment method creation

Stripe Form Flow

When "Auto-fill billing address from IP location" is selected:

User fills out payment details
On form submission, IP-based address is automatically included
Address data is attached to the payment method in Stripe

IP Geolocation Data

The system automatically determines the customer's approximate location based on their IP address and includes:

City name
State or province
Postal/ZIP code
Country code (ISO format)

Best Practices

When to Use Each Option

"Don't collect billing address":
- Digital products with no tax requirements
- Markets where billing address isn't required
- Maximum conversion optimization
"Collect billing address from wallet":
- Physical products requiring shipping
- Services requiring accurate billing address
- Markets with strong address verification requirements
"Don't request address, fill from IP" or "Auto-fill billing address from IP location":
- Digital products with tax requirements
- Reduce checkout friction
- Fallback when accurate address isn't critical
- Good for collecting country/state for tax purposes

Important Considerations

Accuracy: IP-based geolocation may not always be accurate, especially for:
- VPN users
- Mobile networks
- Corporate networks
Compliance: Ensure your address collection method meets:
- Local tax requirements
- Payment processor requirements
- Privacy regulations
User Experience:
- Wallet collection adds a step but provides accurate addresses
- IP auto-fill is seamless but less accurate
- Consider your target audience and requirements