Skip to main content

Set Up the Referrals / IB Program

Goal: Enable and configure the Introducing Broker (IB) and referral program so customers can earn commissions by referring new clients, and so your team can track and pay those commissions. Who does this: Admin / Owner Before you start: You need access to Referrals. Ensure wallet types and deposit/withdrawal methods are already configured (covered in the New Tenant Setup Checklist) — IB commission payouts are processed through the wallet and withdrawal system.

Steps​

  1. Admin / Owner Review the referral overview to understand the current state. Go to Referrals → Overview to see the dashboard of total IBs, referred clients, commissions paid, and active referral chains. If this is a fresh setup, all values will be zero. See Referrals / IB.

  2. Admin / Owner Create your referral types (commission structures). Go to Referrals → Referral Types → Add Referral Type.

    • Enter a Name (e.g., Standard IB, Premium Partner).
    • Select the Commission Model — CPA (fixed per acquisition), Revenue Share (percentage of trading commissions), or Hybrid.
    • Configure Tier Levels and Rates for each tier (e.g., Tier 1: 10% of spread from direct referrals, Tier 2: 5% from sub-referrals).
    • Set the Payout Frequency (daily, weekly, monthly, or on-demand) and Minimum Payout Amount.
    • Save the referral type.

    Create one referral type per commission structure you offer. See Referrals / IB.

  3. Admin / Owner Assign IB status to qualifying customers. Once customers are registered, go to Referrals → Referral Clients and locate the customer you want to designate as an IB. Assign them a referral type to activate their IB status. They will receive a referral link to share with prospects. See Referrals / IB.

  4. Admin / Owner Configure investment bonuses if applicable. If your platform includes investment products, go to Referrals → Investment Bonuses → Create Bonus. Set the trigger event (e.g., new investment reaching a threshold), bonus amount, eligible IB types, and validity period. This is separate from trading commissions. See Referrals / IB.

  5. Admin / Owner Monitor referral trades and commissions. Go to Referrals → Referral Trades to view the log of all trades that have generated commissions — with the client, the IB, commission amount, tier, and payout status. Use this view to verify commissions are accruing correctly and to identify any trades on hold. See Referrals / IB.

  6. Admin / Owner Manage the client tree as the network grows. Go to Referrals → Referral Clients and use the tree view to navigate the IB hierarchy (Parent IB → Referred Clients → Sub-IBs → their clients). Use Reassign to move a client to a different IB parent, or Detach to remove a client from the referral tree entirely. See Referrals / IB.

What happens next​

Once a referral type is active and an IB has been assigned, any customer who registers using that IB's referral link will appear under their node in the client tree, and trades will begin accruing commissions per the configured rates.

Monitor the Referrals → Overview dashboard for growth trends. Check Referral Trades regularly to ensure the payout status is moving from Pending to Paid on schedule.