El siguiente fragmento de código extrae el tracking_id de la URL y lo guarda en localStorage. Use este código si no tiene previsto emplear el script de seguimiento de Partner Network.

fragmento de código para el 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})();

Este script extrae automáticamente el tracking_id de los parámetros de consulta de la URL, lo guarda en localStorage y proporciona el método getTrackingId() que debe utilizarse al generar un token de pago.

Agregue el siguiente script al HTML de su Web Shop:

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

Ejemplo:

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 su tienda está desarrollada con Site Builder, no hace falta realizar ninguna acción adicional: el tracking_id se gestiona automáticamente. Se extrae de la URL y se agrega a la solicitud de token.

Para transmitir tracking_id al widget de compra:

1. Obtenga el tracking_id en el lado del cliente (p. ej., desde la URL o desde el localStorage).

2. Agréguelo al parámetro access_data.user.tracking_id.value durante la inicialización del widget:

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

Para transmitir tracking_id a Pay Station Embed:

1. Obtenga el tracking_id en el lado del cliente (p. ej., desde la URL o desde el localStorage).

2. Transmitir este parámetro al generar el token de pago:

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

3. Utilice el access_token para inicializar el widget:

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

Para transmitir el tracking_id con Headless checkout:

1. Obtenga el tracking_id en el lado del cliente (p. ej., desde la URL o desde el localStorage).

2. Agréguelo al parámetro user.tracking_id.value al generar el token de pago.

3. Inicializar el SDK utilizando el método headlessCheckout.init().

4. Transmita el token mediante:

1await headlessCheckout.setToken('your_token_with_tracking_id');

Token de pago en el lado del cliente

Emplee esta opción si genera el token de pago a través de una de las siguientes llamadas API:

• Crear pedido con todos los artículos de la cesta actual

• Crear pedido con todos los artículos de una cesta específica

• Crear pedido con un artículo especificado

Para transmitir el tracking_id al generar un token pago:

1. Obtenga el tracking_id en el lado del cliente (p. ej., desde la URL o desde el localStorage).

2. Agréguelo al parámetro user.tracking_id.value.

Ejemplo:

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

Token de pago en el lado del cliente

Use esta opción si genera el token de pago mediante la llamada API Crear token de pago para la compra.

Para transmitir el tracking_id al generar un token pago:

1. Obtenga el tracking_id en el lado del cliente (p. ej., desde la URL o desde el localStorage).

2. Agréguelo al parámetro user.tracking_id.value.

Ejemplo:

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

Para transmitir el tracking_id mediante SDK para Unity:

1. Asegúrese de que utiliza una versión reciente del SDK que admita el tracking_id.

2. Obtenga el tracking_id en el lado del cliente (p. ej., vía un vínculo profundo).

3. Transmítalo al objeto Xsolla.Core.PurchaseParams (SDK para Unity).

Ejemplo:

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