Game > Gamebase > Store Console Guide > Apple Console Guide

This document describes how to register and integrate the information of an app released on the App Store with Gamebase Console. There are two methods of integration: (New) Receipt Verification + Notification V2 and (Old) Receipt Verification+Notification V1.

NHN Cloud SDK Integration for iOS Versions

Version	Integration Method
v1.8.0 or later	(New) Receipt Verification + Notification V2, (Old) Receipt Verification + Notification V1
v1.7.*	(New) Receipt Verification+Notification V2
v1.6.2 and earlier	(Old) Receipt Verification + Notification V1

(New) Receipt Verification + Notification V2

Generate keys for in-app purchases

Note https://developer.apple.com/help/app-store-connect/configure-in-app-purchase-settings/generate-keys-for-in-app-purchases

1. Go to App Store Connect > Users & Access > Integrations
2. Click Keys > In-app purchases
3. Click Generate keys for in-app purchases
4. Enter a name for the key and click Generate
5. Click Download in-app purchase key

Enter the in-app purchase key in the store information

1. In the console, select the organization and project, Game > Gamebase > Purchase(IAP) > Add or select an app, and click Modify
2. Store APP ID: Enter your App Bundle ID
3. Receipt Verification and Notification method: Choose (New) Receipt Verification + Notification V2
4. Enter the purchase key, Key ID, and Issuer ID for the downloaded app.

Register Notification V2 URL

1. App Store Connect > Apps > Select an App > General > App information > App App Store Server Notifications
2. Click Edit Production Server URL or Sandbox Server URL
3. Notification version: Select Version 2 Notifications.
4. Enter the server URL: https://api-iap.cloud.toast.com/callback/subscription/{APP_BUNDLE_ID}/AS/v2

(Old) Receipt Verification + Notification V1 (soon to be deprecated)

• Apple subscription billing requires you to create a shared secret and set up a Notification V1 URL in App Store Connect.
• Register the shared secret in the store information.
• Do not need any setup for payments for Apple general merchandise.

Generate a shared secret

Note You can generate a primary shared secret, which is a single secret for all apps, or app-specific shared secret for individual apps. For more information, see https://developer.apple.com/help/app-store-connect/configure-in-app-purchase-settings/generate-a-shared-secret-to-verify-receipts

Primary Shared Secret

1. Go to App Store Connect > Users & Access > Integrations > Shared Secret
2. Click Generate

App-Specific Shared Secret

1. Click App Store Connect > Apps > Select an app > General > App Information > App-Specific Shared Secret > Manage
2. Click Generate

Enter the Shared Secret in the store information

1. In the console,select the organization and project, Game > Gamebase > Purchase(IAP) > Add or select an app, and click Modify
2. Store APP ID: Enter your App Bundle ID
3. Receipt Verification and Notification method: Select (Old) Receipt Verification + Notification V1
4. Enter the Shared Secret

Register a Notification V1 URL

1. App Store Connect > Apps > Select an App > General > App information > App Store Server Notifications**
2. Click Edit Production Server URL or Sandbox Server URL
3. Notification version: Select Version 1 Notifications
4. Enter the server URL: https://api-iap.cloud.toast.com/callback/subscription/{APP_BUNDLE_ID}/AS

Precautions for changing from (Old) Receipt Verification + Notification V1 → (New) Receipt Verification + Notification V2

• If you make changes while the app is running, it may fail, so be sure to make changes during inspections.
• Refer to the (New) Receipt Verification + Notification V2 guide to proceed during the app check.
  • Test thoroughly in Sandbox app before making changes to your product app.
• After completing the checks, a force update is required to ensure that users are using the latest version of the app.
  • If it's not the latest version, users may experience errors when using your app.