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.
    PropertyTypeDescription
    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.

    ​
    Basic Settings

    PropertyTypeDescription
    iOS Browser ModeEnumSets current browser mode: External for opening default browser or SFSVC for embedded Safari.
    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.
    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.

    ​
    iOS Framework Integration

    Enables automatic integration of required iOS frameworks during the Xcode build process.
    Use the following options to exclude parts of the build process. By doing so, you may need to implement part of the process manually.
    PropertyTypeDescription
    Exclude Set Swift Standard Libraries For FrameworkBooleanSkips configuring Swift standard libraries for embedded frameworks.
    Exclude Add Framework Search PathsBooleanPrevents adding framework search paths to the Xcode project.
    Exclude Set LD Runpath Search PathsBooleanPrevents modifying LD_RUNPATH_SEARCH_PATHS for framework loading.
    Exclude Set Swift VersionBooleanSkips setting the Swift language version for the framework target.
    Exclude Set Swift Standard Libraries For MainBooleanPrevents configuring Swift standard libraries for the main app target.
    Exclude Set Code Sign EntitlementsBooleanSkips modifying code signing entitlements related to framework integration.
    Exclude Set Code Sign StyleBooleanPrevents changes to the code signing style (Automatic/Manual).
    Exclude Add XC FrameworkBooleanSkips adding the Appcharge XCFramework to the Xcode project.

    ​
    iOS Entitlements Integration

    Enables automatic integration of required iOS entitlements during the Xcode build process.
    PropertyTypeDescription
    Exclude Create Entitlements FileBooleanSkips creating or modifying the app entitlements (.entitlements) file.
    Exclude Create Associated Domains KeyBooleanPrevents adding the com.apple.developer.associated-domains key to the entitlements file.
    Exclude Add Associated DomainBooleanSkips adding the Appcharge associated domain value to the entitlements configuration.

    ​
    iOS URL Scheme Integration

    Enables automatic integration of the Appcharge iOS URL scheme during the Xcode build process.
    PropertyTypeDescription
    Exclude Set URL Scheme Type RoleBooleanSkips setting the URL scheme type role (e.g., Viewer/Editor) in the app’s Info.plist.
    Exclude Set URL Scheme NameBooleanPrevents setting or modifying the URL scheme display name in the Info.plist.
    Exclude Add URL SchemeBooleanSkips adding the Appcharge URL scheme entry to the app’s URL types configuration.

    ​
    General Auto Integration Settings

    PropertyTypeDescription
    Enable Integration OptionsBooleanDetermines whether the SDK automatically applies required Xcode configurations during build. If disabled, you’ll need to configure them manually in Xcode.
    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 from functioning correctly. If disabled, you must manually configure each required file in Xcode.