Profile & Addresses
Customer profile management and address book
Profile
Get Profile
const profile = await client.customer.getProfile();
// { id, email, firstName, lastName, phone }Since SDK 2.40.0 the profile also carries b2b, the partner (wholesale)
account status: status (NONE, PENDING, APPROVED, REJECTED,
SUSPENDED), companyName, rejectionReason, emailVerificationRequired
and canApply. Drive the account banner by it and offer the application when
canApply is true. isApproved is false only when prices and ordering
are closed for this customer. See
B2B registration and approval.
Update Profile
const updated = await client.customer.updateProfile({
firstName: 'Jan',
lastName: 'Novak',
phone: '+420123456789',
});Change Password
await client.customer.changePassword('oldPassword', 'newPassword');Addresses
List
const { items } = await client.customer.getAddresses();Create
const address = await client.customer.createAddress({
firstName: 'Jan',
lastName: 'Novak',
street: 'Vodickova 12',
city: 'Praha',
zip: '11000',
country: 'CZ',
isDefault: true,
});Update
const updated = await client.customer.updateAddress('address-id', {
street: 'Na Prikope 5',
});Company details and VAT ID
An address can carry companyId, vatId and state. EU VAT IDs are verified
in VIES when the address is saved; the server returns vatIdValid (true,
false, or null when there is no EU VAT ID) and vatIdCheckedAt. Both are
read-only. A changed vatId or country re-runs the check.
const { data } = await client.customer.createAddress({
type: 'BILLING',
isDefault: true,
firstName: 'Jana',
lastName: 'Nováková',
company: 'Nováková s.r.o.',
companyId: '12345678',
vatId: 'SK2020000000',
street: 'Hlavná 1',
city: 'Bratislava',
zip: '811 01',
country: 'SK',
});
data.vatIdValid; // true when VIES confirmed itPrefill checkout from the default address and hand the VAT ID to the cart so the summary shows reverse charge before the customer types anything:
await client.cart.setDestination({ country: address.country, vatId: address.vatId ?? null });updateAddress is partial: { isDefault: true } alone is a valid body. A key
set to null clears the value ({ companyId: null } removes the company ID),
a missing key leaves it unchanged. The address you read from the API can be
sent back as it is, nulls included (SDK 2.14.0).
Delete
await client.customer.deleteAddress('address-id');