Handle Appcharge Payments in Your iOS Game

Once you’ve added Appcharge payment links to your iOS game, the next step is to connect those payments to your in-game logic. This guide walks you through using the PurchaseManager in Unity to launch checkout flows, handle deeplink callbacks, and respond to payment outcomes directly within your game.

For details on setting up the payment links themselves, see Accept Payments in iOS Games with Appcharge Payment Links.

Overview

The PurchaseManager is a Unity MonoBehaviour singleton that acts as the bridge between your game and Appcharge’s payment system that handles:

Launching the external payment flow
Managing loading states through a FlowManager
Capturing the result of the payment via deep links
Reacting to success, failure, or cancellation statuses

Requirements

Before you begin, make sure your project meets the following:

Unity 2020.3 or higher
XCode 13 or higher
Supports deep linking
Your app's Associated Domains / Intent Filters are configured properly for handling payment callbacks.

Step-by-step integration

Create a new GameObject in your initial scene and attach the PurchaseManager script to it. This ensures it’s active when the game starts.
In the Unity Inspector, assign your FlowManager component. This handles the display and hiding of loading indicators during the checkout process.
```
[SerializeField] private FlowManager _flowManager;
```

Handle singleton setup in Awake() and ensures it persists across scenes:

private void Awake()
{
    if (Instance == null)
    {
        Instance = this;
        Application.deepLinkActivated += onDeepLinkActivated;
        DontDestroyOnLoad(gameObject);
    }
    else
    {
        Destroy(gameObject);
    }
}

Triggering a purchase

When the player initiates a purchase, call the OpenCheckout() method:

PurchaseManager.Instance.OpenCheckout();

This method will:

Show a loading spinner _flowManager.ShowLoader(true)
Initiate a session request to the Appcharge backend
Launch an external browser for payment via Application.OpenURL

Handling deeplink callbacks

After the payment flow completes, Appcharge redirects the user back into your app with a URL like:

https://purchase.domain.com?status=success

The onDeepLinkActivated method will automatically handle the incoming URL and log the corresponding purchase status using PurchaseStatusUtils.

private void onDeepLinkActivated(string deeplinkURL) {
    Debug.Log("Deeplink URL: " + deeplinkURL);

    PurchaseStatus status = PurchaseStatusUtils.ParseStatusFromDeepLink(deeplinkURL);

    switch (status)
    {
        case PurchaseStatus.Success:
            Debug.Log("Purchase successful");
            break;
        case PurchaseStatus.Fail:
            Debug.Log("Purchase failed");
            break;
        case PurchaseStatus.Cancel:
            Debug.Log("Purchase canceled");
            break;
        case PurchaseStatus.Close:
            Debug.Log("Purchase closed");
            break;
        default:
            Debug.Log("Unknown purchase status");
            break;
    }
}

You can expand this switch block to show UI messages, grant items, or retry payments based on the status.

Customization

You may expand the switch in onDeepLinkActivated() to handle UI updates or trigger in-game rewards based on the result.

Sample Flow

Player taps "Buy" in the in-game's store.
PurchaseManager.OpenCheckout() is called.
A session is created and a browser is launched.
Player completes or exits the payment.
Deep link is triggered, and the game logs the purchase status.

Full example code

using Appcharge.Networking;  
using Appcharge.Utils;  
using UnityEngine;

namespace Appcharge  
{  
  public class PurchaseManager : MonoBehaviour  
  {  
    public static PurchaseManager Instance { get; private set; }   
      
    [SerializeField]private FlowManager _flowManager;

    private void Awake()
    {
        if (Instance == null)
        {
            Instance = this;
            Application.deepLinkActivated += onDeepLinkActivated;                
            DontDestroyOnLoad(gameObject);
        }
        else
        {
            Destroy(gameObject);
        }
    }

    private void onDeepLinkActivated(string deeplinkURL) {
        Debug.Log("Deeplink URL: " + deeplinkURL);

        PurchaseStatus status = PurchaseStatusUtils.ParseStatusFromDeepLink(deeplinkURL);

        switch (status)
        {
            case PurchaseStatus.Success:
                Debug.Log("Purchase successful");
                break;
            case PurchaseStatus.Fail:
                Debug.Log("Purchase failed");
                break;
            case PurchaseStatus.Cancel:
                Debug.Log("Purchase canceled");
                break;
            case PurchaseStatus.Close:
                Debug.Log("Purchase closed");
                break;
            default:
                Debug.Log("Unknown purchase status");
                break;
        }
    }

    public void OpenCheckout() {
        _flowManager.ShowLoader(true);

        StartCoroutine(
            HttpRequest.CreateSession(
                url => {
                    Application.OpenURL(url);
                }, 
                error => {
                    Debug.Log("Failed to create session: " + error);
                }
            )
        );
    }
}