Developer guide · Referrals
Referrals tied to a real first purchase.
The referral workflow tracks a shared invitation through registration and the referred member’s first qualifying purchase.
- Completion event
- First qualifying purchase
- Reward type
- Configured point rewards
- Scope
- Business referral program
Short answer
Reward the qualifying purchase, not the signup.
Reward Loyalty referrals track an invitation through the referred member’s first qualifying purchase. The partner configures the program and point rewards, the member shares the referral link, and the product prevents the reward from completing on signup alone. This is a built-in application workflow, not a general affiliate or commission engine.
Decision criteria
Define the referral event precisely.
Invitation, verification, attribution, qualifying purchase, reward issuance, and abuse controls are separate parts of the workflow.
Qualifying purchase
State what transaction proves a new customer relationship and which card or program receives the referral points.
Two-sided value
Choose referrer and referred-member rewards that fit the acquisition cost and do not duplicate a welcome offer.
Abuse and support
Test self-referral, duplicate identity, disabled-program, pending, and disputed-purchase behavior before promotion.
Module map
Follow the referral through the real purchase.
The system separates sharing, registration, and completion.
-
1
Partner enables referrals
Configure the participating card and the point reward for each side.
-
2
Member shares a link
The referral page carries the invitation into the new member’s registration path.
-
3
The friend joins
The relationship remains pending because signup alone does not complete the reward.
-
4
The friend makes the first qualifying purchase
The purchase completes the referral and awards the configured points under the current rules.
Product boundary
Use referrals for customer acquisition, not every advocacy idea.
A clear boundary prevents copy from promising events the product does not measure.
Supported
A member invitation that completes after the referred member’s first qualifying purchase.
Separate feature
Achievements can recognize the first successful referral through the fixed catalogue after referral setup exists.
Custom work
Affiliate commissions, recurring revenue share, influencer attribution, custom events, or product-specific referral rules need another implementation.
Product and operating limits
Keep referrals inside their supported purpose.
- The referral does not complete on a share, click, registration, or arbitrary event. It completes on the supported first qualifying purchase.
- Reward Loyalty referrals use the documented loyalty reward model. They are not cash affiliate payouts or recurring commissions.
- Do not describe self-referral protection, identity matching, expiry, or reward conditions beyond the current documented behavior.
Implementation guides
Use current documentation for changing details.
Requirements, interfaces, settings, limits, and release behavior belong in the maintained product documentation.