Sample Acquisition URL

This section explains how to construct a valid acquisition URL, the purpose of each required parameter, and the key rules to ensure referrals are tracked and attributed correctly.

🔗 Acquisition URL

Description

Use the acquisition URL below to direct users to PayAiro through your partner referral link. The referral code and click_id ensure that referrals are tracked correctly and attributed to your partner account.


Sample Acquisition URL

https://yourapp.com/signup?ref=KLINK&click_id=irfan123xyz

Link Parameters and Rules

ParameterRequiredPurpose
ref✅YesYour partner code, such as KLINK. This must exactly match the code PayAiro created and activated for your account.
click_id⭐Strongly recommendedA unique identifier you assign to each user or session, up to 128 characters long.
UTM / otherOptionalAny additional parameters you want stored for your own analytics. These are kept in the attribution JSON but are not used by PayAiro for matching.

📌Important Rules

Use a Unique click_id

Every user you send should get their own distinct click_id. If the same user visits or clicks multiple times, keep the same click_id for them across those visits, since this is what allows their KYC event and their first transaction event to be matched correctly to the original click.


Validate Your ref Code

If the ref value in the link is invalid, expired, or has not yet been activated by PayAiro, the signup attempt will be rejected with an invalid code error.

It is worth testing your link thoroughly before launching a campaign, to avoid sending users to a broken referral code.


Did this page help you?