Le code ci‑dessous permet d’extraire le tracking_id depuis l’URL et de l’enregistrer dans le localStorage. Utilisez ce code si vous ne prévoyez pas d’utiliser le script de suivi du Partner Network.

Extrait pour le traitement du tracking_id :

 1(function () {
 2  const XPN_TRACKING_ID = 'xsolla_partner_network_tracking_id';
 3  const TRACKING_ID = 'tracking_id';
 4
 5  function removeTrackingIdFromUrl() {
 6    if (window.history && window.history.replaceState) {
 7      const url = new URL(window.location.href);
 8      url.searchParams.delete(TRACKING_ID);
 9      window.history.replaceState(null, '', url.toString());
10    }
11  }
12
13  function extractTrackingIdFromURL() {
14    try {
15      const savedTrackingId = localStorage.getItem(XPN_TRACKING_ID);
16      const searchParams = new URLSearchParams(window.location.search);
17      const trackingId = searchParams.get(TRACKING_ID) || savedTrackingId || '';
18      if (trackingId !== '') {
19        localStorage.setItem(XPN_TRACKING_ID, trackingId);
20      }
21      removeTrackingIdFromUrl();
22    } catch (e) {
23      console.error('[Xsolla Partner Network] Failed to extract tracking_id:', e);
24    }
25  }
26
27  function getTrackingId() {
28    return localStorage.getItem(XPN_TRACKING_ID) || null;
29  }
30
31  extractTrackingIdFromURL();
32  window.XsollaPartnerNetwork = window.XsollaPartnerNetwork || {};
33  window.XsollaPartnerNetwork.getTrackingId = getTrackingId;
34})();

Ce script extrait automatiquement le tracking_id depuis les paramètres de requête l’URL, l’enregistre dans le localStorage et fournit la méthode getTrackingId() à utiliser pour générer un jeton de paiement.

Ajoutez le script suivant au code HTML de votre Web Shop :

1<script src="https://cdn.xsolla.net/xpn-bucket-prod/xpn-script/xpn@latest/xpn.min.js"></script>

Exemple :

1const trackingId = XsollaPartnerNetworkSDK.getTrackingId();
2if (trackingId) {
3  console.log('Saved tracking_id from URL:', trackingId);
4  // add tracking_id into your request parameters
5}

Si votre magasin est construit avec Site Builder, aucune action supplémentaire n’est nécessaire, le tracking_id est géré automatiquement. Il est extrait de l’URL et ajouté à la requête de génération du jeton.

Pour passer le tracking_id au widget d’achat :

1. Récupérez le tracking_id côté client (par exemple, depuis l’URL ou le localStorage).

2. Ajoutez-le au paramètre access_data.user.tracking_id.value lors de l’initialisation du widget :

1{
2 access_data: {
3  user: {
4    tracking_id: {
5      value: "abcdefghijklmnopqrstuvwxyz123456"
6    }
7  }
8}
9}

Pour passer le tracking_id à Pay Station Embed :

1. Récupérez le tracking_id côté client (par exemple, depuis l’URL ou le localStorage).

2. Passez ce paramètre lors de la génération du jeton de paiement :

1{
2  "user": {
3    "tracking_id": {
4      "value": "abcdefghijklmnopqrstuvwxyz123456"
5    }
6  }
7}

3. Utilisez le access_token pour initialiser le widget :

1XPayStationWidget.init({
2  access_token: 'your_token_with_tracking_id'
3});

Pour passer le tracking_id avec Headless checkout :

1. Récupérez le tracking_id côté client (par exemple, depuis l’URL ou le localStorage).

2. Ajoutez-le au paramètre user.tracking_id.value lors de la génération du jeton de paiement.

3. Initialisez le SDK à l’aide de la méthode headlessCheckout.init().

4. Passez le jeton en utilisant :

1await headlessCheckout.setToken('your_token_with_tracking_id');

Jeton de paiement côté client

Utilisez cette option si vous générez le jeton de paiement via l’un des appels API suivants :

• Créer une commande à partir de tous les objets du panier actuel

• Créer une commande à partir de tous les objets d’un panier spécifique

• Créer une commande à partir d’un objet spécifique

Pour passer le tracking_id lors de la génération du jeton de paiement :

1. Récupérez le tracking_id côté client (par exemple, depuis l’URL ou le localStorage).

2. Ajoutez-le au paramètre user.tracking_id.value.

Exemple :

1{
2  "user": {
3    "tracking_id": {
4      "value": "abcdefghijklmnopqrstuvwxyz123456"
5    }
6  }
7}

Jeton de paiement côté serveur

Utilisez cette option si vous générez le jeton de paiement via l’appel API Créer un jeton de paiement pour un achat.

Pour passer le tracking_id lors de la génération du jeton de paiement :

1. Récupérez le tracking_id côté client (par exemple, depuis l’URL ou le localStorage).

2. Ajoutez-le au paramètre user.tracking_id.value.

Exemple :

1{
2  "user": {
3    "tracking_id": {
4      "value": "abcdefghijklmnopqrstuvwxyz123456"
5    }
6  }
7}

Pour passer le tracking_id en utilisant le SDK pour Unity :

1. Assurez‑vous d’utiliser une version récente du SDK qui prend en charge le tracking_id.

2. Récupérez le tracking_id côté client (par exemple, via lien profond).

3. Passez-le à l’objet Xsolla.Core.PurchaseParams (SDK pour Unity).

Exemple :

1var purchaseParams = new PurchaseParams {
2  tracking_id = "abcdefghijklmnopqrstuvwxyz123456"
3};