Learn more

Before You Integrate Apple ID Login
 

To integrate Apple ID Login with your online store, you need to set up the 'App ID, Services ID, and Key' in Apple Developer.

An Apple Developer account is essential for these settings.

Confirm Required Information for Login Integration
 

Prepare your store's information for the Apple Developer settings.

The necessary details are listed below.

It's a good idea to jot them down in a text editor like Notepad beforehand.

1. 1. Primary domain / Multi-store primary domain
      
      
      • Go to Settings>General>Store profile to check your domain information.
      • The primary domain is marked with a “Primary” label next to the URL.
   2. Return URLs
      
      

      Based on the domains listed in step 1, write down their Return URLs.
      If your primary domain is Samplemall.com, the Return URL should be:
      https://samplemall.com/Api/Member/Oauth2ClientCallback/apple/
      
      

      • https://your-domain.com/Api/Member/Oauth2ClientCallback/apple/
      • https://www.your-domain.com/Api/Member/Oauth2ClientCallback/apple/
      
      
    

   Note

   Only URLs with the Https:// protocol can be registered as Return URLs.

   If your store currently uses the Http:// protocol, you must update it to Https:// before proceeding with Apple ID login integration.
   
   

   See related articles:

   • How do I ensure my site always opens with https?
   • How do I request an SSL certificate?

   Setting App ID, Services ID, and Key in Apple Developer
   
   

   Go to the Apple Developer site: https://developer.apple.com/ and log in with your developer account.

   1) Setting the App ID

   1. At the top menu, click Account.
      Next, in the Program Resources section, click theCertificates, Identifiers & Profiles > Identifiers button.
   2. Click the blue ＋ button next to Identifiers.
   3. On the Register a new identifier screen, select App IDs and click Continue.
   4. Under Select a type, select App and click Continue.
   5. On the Register an App ID screen, enter the following information and click Continue button.
      • App ID Prefix: If multiple options appear, select the Team ID you wish to use.
      • Description: Enter a description for the App ID.
      • Bundle ID: Select Explicit and enter the App ID identifier in the following format (e.g., com.yourshop.applelogin).
      • Capabilities: Check Sign In with Apple.
        
        
   6. Be sure to Note your Team ID from the App ID Prefix.
      Then click Register.

   2) Setting the Services ID

   1. From the top menu, click Account > Certificates, Identifiers & Profiles > Identifiers.
   2. Click the blue ＋ icon next to Identifiers.
   3. On the Register a new identifier screen, select Services IDs and then click Continue.
   4. On the Register a Services ID screen, enter the following information and click Continue:
      • Description: Enter a description for the Services ID.
      • Identifier: Enter a unique identifier for the Services ID; it must be different from the Bundle ID (e.g., com.yourshop.applelogin.service).
        
        
   5. Click Register.
   6. Find the newly created Services ID in the list and click it.
   7. Check Sign In with Apple and click Configure.
   8. On the Web Authentication Configuration screen, enter:
      • Primary App ID: Select the App ID you created earlier.
      • Domains and Subdomains: Enter all domains you previously noted. Do not include http:// or https://. Use commas to separate multiple domains.
      • Return URLs: Enter all Return URLs you previously noted. You must include https:// protocol before the domain. Use commas for multiple entries.
        
        
   9. Click Next, verify the entered information, and then click Done.
   10. Make sure to Note the Identifier value displayed on the screen.
       Then click Continue and Save.

   3) Setting the Key

   1. From the top menu, click Account.
      Under Program Resources > Certificates, Identifiers & Profiles, click Keys.
   2. Click the blue ＋ icon next to Keys.
   3. On the Register a New Key screen, enter a Key Name. The Key Name is a reference name for easy identification and must be unique (e.g., SignInKey).
      • This name is for reference only and is not used in integration.
      Check Sign In with Apple below and click Configure.
   4. On the Configure Key screen, select the App ID you previously configured under Primary App ID and click Save.
   5. Verify the entered information and click Continue, then click Register.
   6. On the Download Your Key screen, click Download to download the Key file.
      • The downloaded file will be a text file with a .p8 extension.
      • Note: This key file can only be downloaded once. Please store it securely.
   7. Make sure to Note your Key ID value displayed on the screen, then click Done.

   Setting up Apple Login in your store admin panel
   
   

   1. Go to Settings>General>Social/SSO login integration management .
   2. Set Apple Login to Enabled and fill in the following:
      • Services ID
        Enter the Identifier you noted when setting up the Services ID.
        You can find it under Apple Developer > Account > Certificates, Identifiers & Profiles > Identifiers by changing App IDs to Services IDs at the top right.
      • Team ID
        Enter the Team ID you noted when setting up the App ID.
        You can confirm this by clicking on the App ID you set in the Apple Developer > Account > Certificates, Identifiers & Profiles > Identifiers list.
      • Key ID
        Enter the Key ID you noted when setting up the Key.
        You can confirm this by clicking on the Key you set in the Apple Developer > Account > Certificates, Identifiers & Profiles > Keys list.
   3. Click the Save button below. Your settings will be saved.
   Info

   When logging in with Apple, the Services ID, Team ID, and Key ID are used commonly across the main store and multi-shops.

   When you enter the information in the main store, it is automatically reflected with the same information in the multi-shops.

   You don't need to create separate credentials for each multi-shop.

   When configuring the Services ID in Apple Developer, please enter all multi-shop domains in the Return URLs field.