Integration Guide Help

Zeals Affiliate Integration Guide

Overview

This document is intended for Zeals Affiliate partners to help integrate their system with ours.

The following diagram is an overview of general Zeals flow and where partner integration will take place within, assuming the partner already has front-end and back-end.

Diagram

Referring to the above diagram, the blue circles represent integrations that partners will have to perform.

These are the things partners need to do:

  1. Input partner campaigns (To be done by partner's operations team after being given access to Zeals Dashboard)

  2. Integrate Zeals into your platform via our REST API

What Zeals Will Append to Your Landing Pages

Affiliate performance tracking with Zeals Affiliate relies on Zeals Code that we will send as URL parameter.

Example:

https://yourdomain.com/product/12?zeals_code=XXXXXX

It is important to pass this value back via our REST API.

REST API

Hit our API when an acquisition happens. Our API endpoint is as follows:

URL

https://app.zeals.asia/callback

Method

POST

Authentication

Basic PARTNER_ID

Request Body

{ "zeals_code": "xxx", "external_id": "yyy", }

Response

200

Explanation

Key

Description

PARTNER_ID

Zeals-assigned partner ID that we will send to you.

zeals_code

Automatically generated hashcode by the Zeals platform, containing unique information about the affiliate and the campaign.

external_id (Optional)

Transaction ID in your system.

Last modified: 05 February 2025