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

# How to Integrate Hyperzod with Tapfiliate

> This guide walks you through connecting Hyperzod with Tapfiliate.

October 22, 2026

In this article, we will cover:

* [Why Hyperzod is easy to integrate with Tapfiliate](#h_ac5906bc06)
* [What you need before starting the integration](#h_11d43a93e5)
* [Step-by-step setup for tracking and webhook configuration](#h_480440f468)
* [Testing and verification](#h_ecca2a04d8)

## Overview

Tapfiliate can be integrated with [Hyperzod](https://hyperzod.com) to enable **affiliate referral tracking and automated commission attribution**.\

By connecting your Tapfiliate account to Hyperzod, you can track affiliate referrals, manage partners, and reward affiliates automatically when a customer completes an order.\

The integration works through three main steps:

1. Connecting your Tapfiliate credentials inside Hyperzod
2. Adding the Tapfiliate tracking script to your storefront
3. Configuring an order webhook to notify the affiliate system when an order is completed

Once configured, affiliates can promote your store using referral links, and Tapfiliate will attribute conversions accordingly.

##### Pros

* Native integration available in Hyperzod
* Allows automated affiliate tracking and rewards
* Works with completed order events
* No custom development required

##### Cons

* Requires adding the Tapfiliate tracking script to your storefront
* Requires configuring a webhook inside Hyperzod

## Hyperzod Integration Prerequisites

Before starting the integration, make sure you have the following:

* A live Tapfiliate account
* Your **Tapfiliate API Key**
* Your **Tapfiliate Account ID**
* Access to your Hyperzod admin panel

You can obtain your Tapfiliate credentials here:\
[https://support.tapfiliate.com/en/articles/12793297-how-to-find-account-id-and-api-key](https://support.tapfiliate.com/getting-started/essential-account-settings/how-to-find-account-id-and-api-key.md)

## Setting Up the Hyperzod Integration

You will configure:

* Tapfiliate credentials
* Click tracking via JavaScript
* Order conversion tracking via webhook

##### Step 1: Add Tapfiliate Credentials in Hyperzod

After creating your Tapfiliate account, log in to your Hyperzod admin panel.\

Navigate to:\

**Admin Panel → Apps → Loyalty**\

In the Tapfiliate configuration section:

1. Select the **Live Environment**
2. Enter your **API Key**
3. Enter your **Account ID**
4. Click **Save Configuration**

![image-preview](https://mintcdn.com/tapfiliate-help/dUoAZUYA1C6FND70/images/14000262/01-ekjpkd8nj-xq5tyxkp7lo-image.png?fit=max\&auto=format\&n=dUoAZUYA1C6FND70\&q=85\&s=19663ce17bb2e160521dc514d620df2c)

This connects your Hyperzod platform to Tapfiliate.

##### Step 2: Embed the Tapfiliate Tracking Script

Next, you must add the Tapfiliate tracking script to your storefront so affiliate referrals can be detected.

Get the official Tapfiliate JavaScript tracking script from:\

[https://support.tapfiliate.com/en/articles/13111065-how-to-integrate-with-tapfiliate-via-javascript](https://support.tapfiliate.com/integrations/supported-integrations/how-to-integrate-with-tapfiliate-via-javascript.md)

After copying the script, replace:

```
YOUR_ACCOUNT_ID
```

with your actual Tapfiliate Account ID.

Then add the script in Hyperzod:\

**Admin Panel → Settings → Theme → Custom Code → Custom HTML Head**

![image-preview](https://mintcdn.com/tapfiliate-help/dUoAZUYA1C6FND70/images/14000262/02-zjhdwgufxi884mjn2v3x-image.png?fit=max\&auto=format\&n=dUoAZUYA1C6FND70\&q=85\&s=81e3301f1fba817c2ff80c1ee3a763c9)

Paste the updated script into the **Custom HTML Head** section and save the changes.\

This script allows Tapfiliate to detect visitors who arrive via affiliate referral links.

##### Step 3: Configure the Order Webhook

To track conversions when an order is completed, you must configure a webhook in Hyperzod.

Navigate to:\

**Admin Panel → Settings → Webhooks & API Keys**

Create a new webhook with the following configuration.

##### Webhook Name

```
Affiliate Webhook
```

##### Webhook URL

```
https://affiliate.apps.hyperzod.com/api/v1/TENANT_ID/webhook/order/hyperzod
```

Replace **TENANT\_ID** with your own tenant ID.

##### Event

Select the event:

```
Order Completed
```

This webhook ensures that when an order is completed in Hyperzod, the affiliate system receives the event and attributes the conversion accordingly.

![image-preview](https://mintcdn.com/tapfiliate-help/dUoAZUYA1C6FND70/images/14000262/03-rllskngiy6hn9tq-yjvhd-image.png?fit=max\&auto=format\&n=dUoAZUYA1C6FND70\&q=85\&s=9ca2c57050d49bf495ddddebd0581b3d)

![image-preview](https://mintcdn.com/tapfiliate-help/dUoAZUYA1C6FND70/images/14000262/04-l75n-xcfym6jn-v0vul-s-image.png?fit=max\&auto=format\&n=dUoAZUYA1C6FND70\&q=85\&s=f7a5e6df70c5a3ec267487710b3a7755)

## Testing and Verification

Follow these steps to verify that the integration is working correctly.

1. Create a **test affiliate** inside Tapfiliate.
2. Generate the affiliate referral link.
3. Visit your Hyperzod storefront using the referral link.
4. Complete a test order.
5. Confirm that the order event is recorded and attributed to the affiliate.

##### What Happens Next

Once the integration is configured:

* Affiliates can promote your store using Tapfiliate referral links.
* Completed orders in Hyperzod trigger the webhook.
* Tapfiliate attributes the conversion and calculates commissions.

All remaining affiliate management, including **creating affiliates, setting commission structures, and tracking payouts**, is handled inside Tapfiliate.

##### Still Need Help?

If you have any questions or need help setting up the integration, please contact:\

📩 **[support@tapfiliate.com](mailto:support@tapfiliate.com)**

Our team will be happy to assist you.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.