Transactions
ReferralHero supports ongoing transaction tracking, allowing you to reward advocates for transactions completed by their referrals. This is ideal for affiliate programs where commissions are based on recurring or one-time purchases.
Sending Transaction Data
When a referred subscriber completes a transaction, ReferralHero can automatically reward the advocate based on that transaction. Transaction data can be sent to ReferralHero using any of the following methods:
Stripe (native integration)
JavaScript API
REST API
Manual entry via the dashboard
Each transaction is logged with detailed information, enabling accurate tracking and reward issuance.
Transaction Log
All successful transactions are recorded in the Transactions tab under Reward Logs.
Each entry includes:
Time: When the transaction was logged
Subscriber: The person who completed the transaction
Type: Organic or referred
Transaction ID: Stripe Payment ID or one provided via API
Transaction Amount: The total amount of the transaction
Product ID (optional): The ID of the product
Reward ID (if applicable): The ID of the reward that was triggered
Reward Value (if applicable): The value of the reward issued



Setting Up Affiliate Rewards
To configure how and when advocates are rewarded for referred transactions:
1. Enable Transaction-Based Rewards
Toggle ON the setting:
Unlock reward on referral transactions Reward the advocate for each transaction by a [conversion event 1 / 2 / 3] referral.
This determines which referral status qualifies for rewards (e.g., confirmed referrals only).

2. Define Reward Value
Choose how the reward is calculated:
Fixed amount: e.g., $10 per transaction
Percent of transaction: e.g., 10% of each transaction
Defined in transaction: Provide a
reward_value
directly via the API

3. Set Reward Duration
Determine how long rewards should be issued:
By number of transactions: e.g., reward the first 3 purchases
By time period: e.g., reward all transactions within 6 months
Maximum total reward value: Set a cap on the total rewards given per referral

Last updated
Was this helpful?