API Reference
Start typing to search…

Address Billing Address Collection Configuration


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:

  1. "Don't collect billing address" (default)

    • No address collection
    • Minimal friction for users
    • Suitable when billing address is not required

  2. "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

  3. "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:

  1. "Don't auto-fill billing address" (default)

    • Standard behavior
    • No automatic address filling
    • Users must enter address manually if required

  2. "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

  1. 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

  2. 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:

  1. User fills out payment details
  2. On form submission, IP-based address is automatically included
  3. 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

  1. "Don't collect billing address":

    • Digital products with no tax requirements
    • Markets where billing address isn't required
    • Maximum conversion optimization

  2. "Collect billing address from wallet":

    • Physical products requiring shipping
    • Services requiring accurate billing address
    • Markets with strong address verification requirements

  3. "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

  1. Accuracy: IP-based geolocation may not always be accurate, especially for:

    • VPN users
    • Mobile networks
    • Corporate networks

  2. Compliance: Ensure your address collection method meets:

    • Local tax requirements
    • Payment processor requirements
    • Privacy regulations

  3. 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