Customer
The Customer object represents the profile of an authenticated user within your store. It contains basic personal information, contact preferences, and the user's fiscal status.
Customer Definition
| Property | Type | Description |
|---|---|---|
| id | string (UUID) | Unique identifier for the customer. |
string | Registered email address. | |
| displayName | string | User's full name or display name. |
| emailVerified | boolean | Indicates whether the email address has been verified. |
| provider | string | Authentication method used: password. |
| createdAt | string (ISO 8601) | Date and time the profile was created. |
| twoFactorEnabled | boolean | Indicates if two-factor authentication (2FA) is active. |
| vatExempt | boolean | If true, the user is entitled to VAT exemption (e.g., intra-EU purchases with a valid VAT ID). |
| vatCode | string | VAT ID or Tax Code associated with the profile. |
| newsletter | boolean | Indicates if the user has consented to marketing communications. |
Object Example
{
"id": "00e72027-3672-4c12-a78f-e9ff744a0892",
"email": "[email protected]",
"displayName": "John Doe",
"emailVerified": true,
"provider": "password",
"createdAt": "2025-11-24T14:16:04.670Z",
"twoFactorEnabled": true,
"vatExempt": false,
"vatCode": "IT01234567890",
"newsletter": true
}
Tax Management
The vatExempt property is essential during checkout: when set to true, the webround.com engine automatically recalculates cart totals by excluding taxes.
The vatCode is crucial for communicating the tax ID to Stripe to be included as the invoice recipient.