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
Country!
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
String
The area postal code or ZIP code, which is used for shipping and billing purposes.

​
Mutations