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
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