This feature is in closed beta, which means that only specific customers can access it now. If you want to implement it in the future, please contact our support.
On VTEX, customers don't need to create an account or log in to make a purchase. However, if they want to change the information provided during their first purchase, they must prove the email belongs to them.
The platform natively allows logging in with email and password or using an access code sent to the customer's email. We also offer optional native integrations with Apple ID, Google, and Facebook, which need to be configured. This guide explains the required configuration to enable Sign in with Apple ID in your store:
- Prerequisites
- Registering on Apple
- Completing the authentication information
- Testing Sign in with Apple ID
- Limitations
Prerequisites
Before configuring Sign in with Apple ID for your store, you need to have an Apple ID and be enrolled in the Apple Developer Program.
Registering on Apple
To configure the login integration with Apple, you must create OAuth 2.0 credentials (the protocol used for integration) in this service. To do so, follow the instructions in our Registering credentials to set up Apple ID login developer guide.
Completing the authentication information
Once you have registered with Apple, enable the option of logging in to your store using this provider by following the instructions below. Make sure you have the credentials provided in the registration step.
-
In the top bar of the VTEX Admin, click your profile avatar, indicated by the initial letter of your email address.
-
Click Account settings > Authentication.
You will be redirected to the Webstore tab of the Authentication page, which lists the login methods available in your store.
-
In the Apple row, click
Set Up
. -
Complete the configuration fields with the credentials previously registered on Apple:
- Key ID: Identifier of the private key generated by Apple that VTEX will use to generate the OAuth client secret.
- Team ID: Identifier of your team on the Apple Developer Portal.
- Service ID: Identifier of your Apple service, which will be used as the OAuth
client_id
. - P8 Certificate: Private key saved as a text file with a
.p8
file extension generated only once by Apple when creating the key.
Check out the Registering credentials to set up Apple ID login developer guide to learn how to get these credentials.
-
Click
Save
. -
Click
Webstore Providers
to go back to the previous page. -
Click the switch to enable Apple as the login provider.
Testing Sign in with Apple ID
Once everything is configured, you can test it. We recommend that you test the configuration with the final URL through which users will access your store. The Apple ID option should be available when you try to log in.
- Go to your store's website and click
Sign In
. - Click
Sign in with Apple
. You will be taken to the Apple login window. - Enter your Apple ID and password.
- Complete the two-factor authentication if requested.
- Choose whether to share your email with the app or hide it and click
Continue
. We recommend sharing the email, as there are limitations with hidden email on VTEX.
The option of whether to share your email appears only when you first access the store with your Apple ID. After that, you only need to click
Continue
. To reset the email sharing option, visit Apple ID management, revoke your store authorization, and log in again.
By doing so, you will be logged in to the store.
Limitations
Please consider the current limitations on logging in with Apple ID in VTEX stores:
-
Message Center is not compatible with Apple emails, so emails configured in the tool will not be sent to users who log in with an Apple ID.
-
If the user chooses to use Apple's Hide My Email feature, VTEX will generate a new account every time the user logs in.
This means that if someone initially logs in with an email and password, places an order, and later logs in using Apple ID with the hidden email feature enabled, VTEX will create a separate account. This new account will not be associated with the original account and will not allow access to order history or other user information. This action cannot be undone.