Add Checkout Billing Address
Adds a billing address to an existing *Checkout*.
**Required Fields**
* country_code
> #### Note
> * The `email` property is only required if the customer is a guest shopper. Otherwise, it is set automatically.
> * Sending `email` property as a payload in POST request triggers the abandoned cart notification process.
> * Substitute your storefront domain for `yourstore.example.com`.
> * The Send a Test Request feature is not currently supported for this endpoint.
> * This endpoint requires using Stencil CLI, a local session, and a csrf token to work.
Path parameters
checkoutId
Request
This endpoint expects an object.
countryCode
ISO 3166-1 alpha-2 country code. (See: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
address1
address2
city
company
country
Country name.
customFields
email
firstName
lastName
phone
postalCode
stateOrProvince
Represents state or province.
stateOrProvinceCode
version
The cart version that you expect to apply the updates. If the provided version doesn’t match the current cart version, you will receive a conflict error. This field is optional; if not provided, optimistic concurrency control will not apply.
Response
billingAddress
cart
A cart contains a collection of items, prices, discounts, etc. It does not contain customer-related data.
channelId
Channel ID.
consignments
coupons
Coupons applied at the checkout level.
fees
Fees applied at the checkout level.
createdTime
Time when the cart was created.
customer
Customer details.
customerMessage
Shopperʼs message provided as details for the order to be created from this cart
giftCertificates
Applied gift certificate (as a payment method).
giftWrappingCostTotal
Gift wrapping cost for all items, including or excluding tax.
grandTotal
The total payable amount, before applying any store credit or gift certificate.
handlingCostTotal
Handling cost for all consignments including or excluding tax.
id
isStoreCreditApplied
true value indicates StoreCredit has been applied.
orderId
outstandingBalance
grandTotal subtract the store-credit amount
payments
promotions
shippingCostBeforeDiscount
Total shipping cost for the checkout before discounts are applied.
comparisonShippingCost
Total shipping cost for the checkout after automatic promotions are applied.
shippingCostTotal
Shipping cost before any discounts are applied.
shouldExecuteSpamCheck
subtotal
Subtotal of the checkout before applying item-level discounts. Tax inclusive based on the store settings.
taxes
taxTotal
updatedTime
Time when the cart was last updated.
version
The current version of the checkout increments with each successful update. You can use it to enable optimistic concurrency control for subsequent updates.
Errors
409
Conflict Error
