This article describes how to set up the iOS Mobile Checkout SDK for Unity.

​
Step 1 | Import the SDK

To import the iOS Mobile Checkout SDK for Unity, open your project and either:

  • Double-click Unity package file, or
  • Drag and drop the package file into your Assets folder.

​
Step 2 | Configure the SDK

To configure the SDK:

  1. Go to Assets > Resources > Appcharge. You should see a file named AppchargeiOSConfig. If the file doesn’t exist, right-click the Appcharge folder and select Create > Appcharge > Configuration > AppchargeiOSConfig.

  2. Select the AppchargeiOSConfig file. In the Inspector tab, fill in the required fields:

    FieldDescription
    EnvironmentThe checkout environment. Select Sandbox for testing or Production for live operations.
    Checkout Public KeyThe checkout public key, located in the Publisher Dashboard. In the sidebar menu, click Settings, then select the Integration tab. Copy the Checkout Public Key value.
    Use External BrowserWhether the checkout opens in the device’s default external browser.
    Important: Set this based on your regional compliance requirements. See the Regional compliance guidelines section below.
    Automatic IntegrationWhether the SDK automatically applies required Xcode configurations during the build. If disabled, the following options will be turned off and you’ll need to configure them manually in Xcode.
    Add Framework To XCode ProjectWhether to automatically include and sign the Appcharge iOS frameworks in your Xcode project.
    Add Applinks EntitlementWhether to add the applinks prefix to your domain. Required for implementing Universal Links.
    Applinks DomainThe domain used to redirect players back to your game, without HTTP protocol. For example, my-best-game.com.
    Add URL SchemaWhether to enable deeplink support to open the checkout in an embedded browser.

​
Regional compliance guidelines

Configure the Use External Browser setting according to your region’s legal requirements:

  • U.S. Compliance (External Browser):

    Enable Use External Browser to comply with U.S. payment flow regulations. This setting opens the checkout in the device’s default external browser.

  • European DMA (In-App Browser):

    Disable Use External Browser to comply with European DMA. This setting keeps the checkout flow within the app using an embedded browser.