Skip to main content
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
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
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
The email address of the buyer. This field is important for sending transactional emails, like order confirmations, shipping updates, or password resets.
​
phone
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
The first line of the buyer’s address, which typically includes the street name and building number.
​
address2
The second line of the buyer’s address, can include additional information like apartment or suite numbers.
​
city
The name of the city, district, village, or town where the buyer is located.
​
provinceCode
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
Two letter ISO 3166-1 alpha-2 country code. Territories not explicitly defined in the Country enum are treated as subdivisions of their respective parent countries.Example: US for United States, or NZ for New Zealand.
​
postalCode
The area postal code or ZIP code, which is used for shipping and billing purposes.

​
Mutations