Referral program

The Referral program turns any URL into an attributable acquisition channel. You create links tied to a partner, clients click through, and every downstream action — registration, deposit, first trade — is bound back to the original click for commission and reporting.

Core concepts

Concept	Description
`Link`	A configured entry point owned by a partner. Carries UTM parameters, regional routing, encryption settings and a tracking ID.
`Click`	A single visit to a link. Captures IP, user-agent, fingerprint, session cookie and geographic metadata.
`Event`	A downstream business action (e.g. `FIRST_DEPOSIT`) tied back to a click through the session cookie or a stored `click_id`.
`Partner ID`	Identifier for the IB / affiliate. Can be emitted in plaintext (`ref=`) or encrypted (`Formx=`).
`Postback`	Outbound webhook fired by FYNXT to your endpoint whenever a configured event type occurs.

Link anatomy

A published FYNXT referral link has this shape:

https://go.zenithfx.com/click
  ?Formx=a8f...d2e            // encrypted partner ID
  &utm_source=youtube
  &utm_campaign=q2-launch
  &landingpage=/en/open-account
  &lang=en

When a visitor hits the link, FYNXT records a referral_click row, drops a first-party FYNXT_SESSION_ID cookie, and 302-redirects to the landing page with ?clickId=...&sessionId=... appended.

Attribution

By default, FYNXT uses first-click attribution: a visitor's first recorded click is stamped onto the cookie and persists for 30 days. Last-click is available as a per-program override.

When the client completes a registration or deposit, your backend calls POST /v1/referral/events with the session_id or click_id, and the event is bound to the original click.

Event lifecycle

Visitor clicks a FYNXT link → referral_click recorded, cookie set.
Visitor lands on your page → fynxt.js reads the session cookie.
Visitor registers → your backend posts REGISTRATION event.
FYNXT attributes event to the first click, stores referral_event.
FYNXT fires a configured Postback to your downstream endpoints.
Event feeds into CPA and rebate calculation pipelines.

Supported event types: REGISTRATION, VERIFICATION, KYC_COMPLETED, FIRST_DEPOSIT, FIRST_TRADE, RECURRING_DEPOSIT, WITHDRAWAL, ACCOUNT_UPGRADE, SUBSCRIPTION, EMAIL_SIGNUP, CONTENT_DOWNLOAD, WEBINAR_REGISTRATION, DEMO_ACCOUNT_CREATION, NEWSLETTER_SUBSCRIPTION, CUSTOM.

← Back

All docs

Postback introduction