O trecho abaixo extrai o tracking_id do URL e salva-o no localStorage. Use esse código se você não planeja usar o script de rastreamento da Partner Network.

Trecho de processamento do 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})();

Esse script extrai automaticamente o tracking_id dos parâmetros de consulta do URL, salva-o no localStorage e fornece o método getTrackingId() a ser usado ao gerar um token de pagamento.

Adicione o seguinte script no HTML da sua Web Shop:

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

Exemplo:

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

Se sua loja foi construída no Site Builder, nenhuma ação adicional será necessária — o tracking_id é gerido automaticamente. Ele é extraído do URL e adicionado à solicitação de tokens.

Para passar o tracking_id ao widget de compra:

1. Obtenha o tracking_id no lado do cliente (ex.: do URL ou do localStorage).

2. Adicione-o ao parâmetro access_data.user.tracking_id.value durante a inicialização do widget:

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

Para passar o tracking_id para o Pay Station Embed:

1. Obtenha o tracking_id no lado do cliente (ex.: do URL ou do localStorage).

2. Passe esse parâmetro enquanto gera o token de pagamento:

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

3. Use o access_token para inicializar o widget:

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

Para passar o tracking_id com o Headless checkout:

1. Obtenha o tracking_id no lado do cliente (ex.: do URL ou do localStorage).

2. Adicione-o ao parâmetro user.tracking_id.value enquanto gera um token de pagamento.

3. Inicialize o SDK usando o método headlessCheckout.init().

4. Passe o token usando:

1await headlessCheckout.setToken('your_token_with_tracking_id');

Token de pagamento no lado do cliente

Use essa poção se você gerar o token de pagamento via uma das seguintes chamadas de API:

• Criar pedido com todos os itens do carrinho atual

• Criar pedido com todos os itens de um carrinho específico

• Criar pedido com item especificado

Para passar o tracking_id ao gerar um token de pagamento:

1. Obtenha o tracking_id no lado do cliente (ex.: do URL ou do localStorage).

2. Adicione-o ao parâmetro user.tracking_id.value.

Exemplo:

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

Token de pagamento no lado do servidor

Use essa opção se você gerar o token de pagamento pela chamada API Criar token de pagamento para compra.

Para passar o tracking_id ao gerar um token de pagamento:

1. Obtenha o tracking_id no lado do cliente (ex.: do URL ou do localStorage).

2. Adicione-o ao parâmetro user.tracking_id.value.

Exemplo:

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

Para passar o tracking_id usando o SDK para Unity:

1. Certifique-se de usar uma versão SDK recente que suporta o tracking_id.

2. Obtenha o tracking_id no lado do cliente (ex.: via link profundo).

3. Passe-o no objeto Xsolla.Core.PurchaseParams (SDK para Unity).

Exemplo:

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