The ReferralHero Blockchain Integration is very powerful and allows you to track and confirm on-chain conversion events for referrals. When a referral meets the defined event their referral status will change from pending to confirmed and the referral will officially count towards the referrer (ie. points accumulated, rewards unlocked, etc.).

ReferralHero currently supports on-chain tracking for:

  • BNB Chain

  • Ethereum

  • Solana

To use this feature ReferralHero subscribers must have verified crypto wallet addresses.

Crypto Wallet Address Verification

To enable the blockchain integration you must:

1. Set 'crypto wallet address' as the primary/secondary unique identifier


2a. If you are using our widget to create subscribers, they must verify their crypto wallet address


2b. If you are using our Javascript API, REST API, or SDK to create subscribers, you must send these fields (crypto_wallet_address & crypto_wallet_provider) to the subscriber profile, as shown here.

To enable crypto wallet address verification through our widget:

  1. Go to Edit Campaign > Unique Identifier > Select Crypto Wallet Address as your primary/secondary unique identifier

  2. Enable Verification Method > Select the crypto wallets you would like to activate to verify wallet addresses

  1. Users will now be given the option to connect and verify their crypto wallet address directly through our widget.

  1. ReferralHero will automatically check to see if the chosen wallet is activated in the browser extension. If it is, the wallet will automatically connect, and once the 'sign up' is complete the subscriber will be verified.

Blockchain On-Chain Tracking

To set up the Blockchain on-chain tracking integration:

  1. Go to your campaign dashboard > Edit Campaign > Integrations > Blockchain and click on Add Event To Track

  1. In the popup, enter the following:

  • Blockchain on which the transaction occurs

  • Name your tracking event

  • Select the conversion value that should be displayed in the subscriber profile

  • Set up as many relevant on-chain definitions

  1. Click Start Tracking to close the popup Click Save

  • Blockchain integration only works for campaigns set up with ‘multi-step conversion events’ as the campaign goal

  • You will not be able to use the Blockchain integration to track events that do not occur on a blockchain, e.g. fiat on-ramp transactions, etc

Blockchain On-Chain Tracking Example

The following example illustrates how a ReferralHero on-chain tracking event can be set up:

  1. Add the event to track by specifying the blockchain, event name, the conversion event (tokens transferred), and the transaction definitions (e.g. contract address).

  1. A referral signs up to your referral campaign, and later performs the required event on BNB Chain.

  2. The on-chain transaction occurs and is created on the BNB Chain.

  1. The referral’s status is confirmed and the conversion value is sent to ReferralHero for your onward action.

Last updated