Set Billing Address

Set or update the billing address for the checkout process.

Endpoint

POST /api/shop/checkout/billing-address

Request Headers

Header	Required	Description
Content-Type	Yes	application/json
X-STOREFRONT-KEY	Yes	Your storefront API key
Authorization	Yes	Bearer token (customer login required)

Request Body

Option 1: Use Saved Address

{
  "addressId": 1
}

Option 2: Same as Shipping Address

{
  "useShippingAddress": true
}

Option 3: New Address

{
  "firstName": "Jane",
  "lastName": "Doe",
  "email": "[email protected]",
  "address": "456 Oak Ave",
  "city": "Los Angeles",
  "state": "CA",
  "country": "US",
  "postcode": "90001",
  "phone": "9876543210"
}

Response Fields (200 OK)

Field	Type	Description
billingAddress	object	Confirmed billing address
message	string	Success message

Billing Address Fields

Field	Type	Description
id	integer	Address ID
firstName	string	First name
lastName	string	Last name
email	string	Email
address	string	Street address
city	string	City
state	string	State/Province
country	string	Country code
postcode	string	Postal code
phone	string	Phone number

Use Cases

• Set billing destination
• Use different address for billing
• Validate billing address
• Create customer invoice address
• Proceed to order placement

Related Resources

• Set Shipping Address
• Get Checkout Addresses
• Create Order