App Store Connect (Apple)

Available in Classic and VPC

This is a console user guide for using the Apple ID login feature.
For more information on how to use the console other than GAMEPOT integration, see the App Store Connect page.

Apple sign-in

You must be enrolled in the Apple Developer program, and implementing Apple's web login feature involves a few key steps.

Apple's "Sign in with Apple" feature allows users to log in to your website or application using their Apple ID. This requires an Apple Developer account and requires some setup and code implementation.

Checkpoints before setting up console

1. Make sure that the "Paid Apps Agreement" is enabled in Tax and Banking > Agreements.
   

2. You must have a bank account listed in Tax and Banking > Bank Accounts that you can transact with.

3. In the far right side of the Apps > In-App Purchases > In-app purchase list, make sure it says "Ready to Submit."

Set Apple ID login

1. Set client ID

1. In Apple Developer Console > Certificates, Identifiers & Profiles > Identifiers, select the IDENTIFIER for the app you want to apply.

• If you don't have created APP ID
  
  
  1-1. In Apple Developer Console > Certificates, Identifiers & Profiles > Identifiers, select "+". 
  

1-2. Select Register a New Identifier > App IDs.

1-3. Enter the Platform, Description (game title), Bundle ID (explicit) for Register an App ID and click Continue.

2. On the Capabilities tab, select Sign In with Apple > click the Edit button on the right.
   

3. Select Enable as a primary App ID, and then save it.

2. Set service ID/callback URL

1. In Apple Developer Console > Certificates, Identifiers & Profiles > Identifiers, click the "+" button to select Services ID, and then click the Continue button.
   

2. Enter Description and Identifiers, click the Continue button, and click the Register button to complete the creation.

• Description: Enter the app title.
• Identifiers: Identifiers are used for Apple login, so it is recommended to write them based on Bundle ID for easy identification. {e.g., Bundle ID.webauth}
  

3. Select the generated Services ID, and then click the Configure button for the Sign In with Apple field.

4. Select the app you want to use for the Primary App ID field, and click the "+" button next to the Website URLs field.

5. Enter GAMEPOT API domain and Return URL in the Register Website URLs field.
e.g., If Return URL is [https://gpapps.gamepot.ntruss.com/v1/auth/apple/callback/{projectid}],
the API domain will be [gpapps.gamepot.ntruss.com].

6. Add the IDENTIFIER of the created Services ID to the GAMEPOT dashboard > Project settings > General > Apple ID login > Client ID field.
   

3. Check team ID

• You can find it in Apple Developer Console > Account > Membership details at the bottom.
  

• You can also find your TeamId in the top right corner of the Certificates, Identifiers & Profiles page.
  

4. Set key

1. In Apple Developer Console > Certificates, Identifiers & Profiles > Keys, click the "+" button.
   

2. Enter Key Name, select Sign in with Apple, and then click the Configure button.
   

3. Select the app to use in the Primary App ID field, and then click the Save button.
   

4. Click the Register button, and then click the Download button to download the .p8 file.
   

5. Open the downloaded .p8 file, copy the entire content and enter it into the GAMEPOT dashboard > Project settings > General > Apple ID Login > Private Key field.
   • The file can be opened via Xcode or Notepad, etc.

{height="" width="50%"}'

6. Enter the "Key ID" field of the generated key in the Apple ID login > Key ID field.
   

5. Enhance Apple receipt validation

GAMEPOT dashboard > Project settings > General > Validate Apple Store payment receipt

• Allowed bundle IDs: When validating receipt, it compares the bundle ID ( XX.XX.XX ) in the Apple receipt and if it is wrong, it will be judged as an illegal payment and the payment will fail.
  => Although not required, it is recommended to set it as there are many cases of illegal payments from abroad.
• App-Specific Shared Secret: If you add this information, it will perform additional fake payment validation and fail the payment if it does not match.

How to check app-specific shared secret (Apple Password)

1. App Store - Select project - App Information - App-Specific Shared Secret - Click Manage
   

2. Users and Access - Shared Secret

6. App Store server notifications

This part is used to get payment cancellation information, and GAMEPOT only supports V1 notification type.
The notification address can be obtained by clicking the GAMEPOT dashboard > Payment > Payment cancellation > App Store > Copy address button. (The relevant address varies depending on the dashboard Region. )

7. Set in-app payment StoreKit

1. Create a file like SyncedProducts.storekit to sync it.
   

2. Ensure that you're connected to Product -> Scheme -> Edit Scheme -> Run -> StoreKit Configuration.
   

• Go to the Root folder, click New File, and then select StoreKit to create it.