Most of the fields in this object are optional. This allows for partial updates to Buyer Identity information when making calls to updateCartBuyerIdentity mutation. However, it’s important to note that a complete and valid Buyer Identity is required when submitting the cart.

Fields

firstName
String

The first name of the buyer. This field can be used to personalize communications with the buyer and to identify the buyer in any customer support interactions.

lastName
String

The last name of the buyer. Similar to the firstName field, this field is used to personalize communications and identify the buyer in support interactions.

email
String

The email address of the buyer. This field is important for sending transactional emails, like order confirmations, shipping updates, or password resets.

phone
String

A 10-digit phone number, in E.164 format.

This field can be used for contacting the buyer in case of any issues with their order or for providing customer support.

address1
String

The first line of the buyer’s address, which typically includes the street name and building number.

address2
String

The second line of the buyer’s address, can include additional information like apartment or suite numbers.

city
String!

The name of the city, district, village, or town where the buyer is located.

provinceCode
String

The 2-3 letter province code which identifies the buyer’s state or province, in ISO 3166-2 format.

Example: NY for New York, AUK for Auckland.

countryCode
required

The 2-letter country code, in ISO 3166 format.

Example: US for United States, or NZ for New Zealand.

postalCode
String

The area postal code or ZIP code, which is used for shipping and billing purposes.

Mutations