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.

This feature is only available when your campaign Goal is set to Conversion Event.

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

If our Stripe integration is being used, we save the payment_intent and amount from the charge.succeeded event, which represents the Payment ID and Payment Amount for a Stripe transaction.

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?