This tutorial suggests how you can integrate Appcharge Payment Links into a Unity iOS game. To demonstrate the integration, we created a sample Unity app that implements the full flow. We provide a step-by-step breakdown of the implementation, detailing each part of the process to help you adapt it to your own project. You can view the sample app on our GitHub repository.

​
Before you begin

Before you begin, make sure you have the following:

  • Unity version 2020.3 or higher
  • XCode version 13 or higher
  • Support for deep linking
  • Your app has properly configured Associated Domains to handle deeplink callbacks.

​
Step 1 | Initialize the class

We create a PurchaseManager class to act as the bridge between our game and the Appcharge payment system. Then we add an event that is triggered when our game receives a deeplink:

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

We parse the payment status from the deeplink, and then implement our game logic based on the status.

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

    PurchaseStatus status = PurchaseStatusUtils.ParseStatusFromDeepLink(deeplinkURL);
	 	
  	// Validate the order and game balance here before handling the payment result
  
    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;
    }
}

​
Step 3 | Launch the checkout flow

We make a request to our game server to create a session and retrieve the checkout URL. If the checkout URL is retrieved, we use the link to open the checkout from our game.

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

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

​
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);
                }
            )
        );
    }
}

​
License

Proprietary – © Appcharge. All rights reserved.