Skip to main content
This article explains how to integrate Unity Payment Links with the iOS platform. To integrate with iOS:
  1. Go to the Build Settings window and make sure your Unity project is set to iOS. Once set, the AppchargeConfig file updates to display iOS-specific configuration options. iOS Build Settings
  2. Your configuration settings should look like this: iOS Configurations
    By default, the configuration file is preconfigured for integration. However, you must set the required Environment and Checkout Public Key fields under Publisher Info.

    Publisher Info

    These settings can also be changed at runtime, but doing so requires re-initializing the SDK.
    PropertyValueDescription
    EnvironmentEnumSets the checkout environment. Use Sandbox for testing and Production for live payments.
    Checkout Public KeyStringDefines the checkout public key. You can find it by going to the Publisher Dashboard → Settings → Integration.

    Auto Integration Settings

    PropertyValueDescription
    Portrait Orientation LockBooleanForce the internal browser to open in portrait mode even if the application is set to landscape.

    Note: You can update this property programmatically before launching the checkout.
    Add Framework To XCode ProjectBooleanAutomatically includes and signs the Appcharge iOS frameworks in your Xcode project.
    Associated DomainBooleanSpecifies the domain used to redirect players back to your game (without the HTTP protocol). Example: my.best-app.com. The domain must be served via https, not http.
    Add URL SchemaBooleanEnables deeplink support to open the checkout in an embedded browser.

    General Auto Integration Settings

    PropertyValueDescription
    Enable Integration OptionsBooleanDetermines whether the SDK automatically applies required Xcode configurations during build. If disabled, you’ll need to configure them manually in Xcode.
    Use Internal BrowserBooleanIf enabled, the checkout opens using SFSafariViewController. If disabled, the default browser will be used. See Sell Outside IAP for more info.

    Note: You can update this property programmatically before launching the checkout.
    Enable Debug ModeBooleanWhen enabled, prints a summary of automatic integration changes after the build completes.
    Disabling Enable Integration Options prevents the automatic configuration required for the Checkout SDK to function correctly. If disabled, you must manually configure each required file in Xcode.