> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tolt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Track with tolt.js

> Track partner clicks, leads, and payments using the tolt.js script

## Installation

First, add the tolt.js script to the head of your website/app:

<Tabs>
  <Tab title="Default">
    ```html theme={"system"}
    <script
      src="https://cdn.tolt.io/tolt.js"
      data-tolt="YOUR_PUBLIC_ORG_KEY"
    ></script>
    ```
  </Tab>

  <Tab title="Alternative">
    ```javascript theme={"system"}
    <script>
      var toltScript = document.createElement('script'); 
      toltScript.src = 'https://cdn.tolt.io/tolt.js'; 
      toltScript.setAttribute('data-tolt', 'YOUR_PUBLIC_ORG_KEY'); 
      document.head.appendChild(toltScript);
    </script>
    ```
  </Tab>
</Tabs>

## Tracking Flow

### 1. Click Tracking

The tolt.js script automatically tracks visitors that come through partner links:

* When a visitor arrives through a partner link, tolt.js creates a click
* The click data is accessible through `window.tolt_data`:

```javascript theme={"system"}
{
  click_id: "30aa8b8d-b846-4827-bd6f-6beb16466841",
  cookie_duration: 30,
  partner_id: "f468da94-f786-485c-9314-3008ce472188",
  program_id: "prg_YRsbPDAKhWAdqJbFACheh",
  customer_id: null  // Will be set after signup
}
```

### 2. Lead Tracking

When a visitor signs up, convert them to a lead using the signup function:

```javascript theme={"system"}
const result = await window.tolt.signup("user@example.com");
// Returns signup data including customer_id
```

After signup, store the `customer_id` and `partner_id` from `window.tolt_data` in your database. You'll need these to track future payments for this customer.

### 3. Payment Tracking

When the customer makes a payment, call the [create a transaction](/transactions/create) API:

```bash theme={"system"}
curl -X POST 'https://api.tolt.com/v1/transactions' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
    "amount": 9999,
    "customer_id": "cust_dK9bzRGn46BhVgNFHD6fDgXW",
    "billing_type": "subscription",
    "charge_id": "ch_9bzRGn46BhVgNFHD6fDgXW",
    "product_name": "Premium Plan",
    "source": "stripe",
    "interval": "month"
}'
```

When a transaction is created, Tolt automatically:

1. Identifies the associated partner through the customer\_id
2. Triggers the programs commission flows
3. The flows will create a commission record for the partner if the conditions are met

This completes the tracking cycle from initial click through to paid commission.