Back to overview
Lesson 5 of 5

Configuring IB Deals in Practice

7 min read

Understanding commission models is one thing. Actually configuring them inside a platform, connecting them to MT4 or MT5 trade data, and running automated payouts is where most Forex brokers hit friction. This lesson covers the practical side: what deal configuration looks like in production, how trading platform integration feeds commission calculations, and how to build a payout workflow that runs reliably at scale.

Deal Configuration Workflow

A deal configuration starts with the IB agreement and translates its terms into system logic. Every deal needs four components defined: the commission model (lot-based, spread-based, hybrid), the rate or rates, the qualification rules, and the payout schedule. In practice, most brokers maintain 3--5 deal templates that cover their standard tiers, plus custom deals for top-performing IBs.

  • Step 1: Define the commission model -- lot-based, spread-based, CPA, or hybrid combination
  • Step 2: Set rates per account type -- different rates for standard, pro, and ECN accounts
  • Step 3: Configure qualification rules -- minimum deposit, lot thresholds, hold periods, clawback triggers
  • Step 4: Define multi-tier overrides -- master IB and sub-IB cascade rates if applicable
  • Step 5: Set the payout schedule -- weekly, bi-weekly, or monthly with minimum payout threshold
  • Step 6: Activate the deal and assign it to the IB account in the affiliate management platform

MT4 and MT5 Integration for Commission Calculation

Forex IB commissions depend on trade data from MT4 or MT5 -- specifically, the lot size, instrument, open/close time, and the account the trade was executed on. The affiliate management platform needs to pull this data in near real time to calculate commissions accurately. There are two integration approaches: API-based polling and server plugin.

Integration MethodHow It WorksLatencySetup Complexity
Manager API pollingPlatform queries MT4/MT5 API on a schedule (every 1--5 minutes)1--5 minutesMedium -- requires API credentials and scheduled jobs
Server pluginPlugin on the MT4/MT5 server pushes trade events in real timeUnder 1 secondHigh -- requires server access and plugin deployment
Database syncDirect read from MT4/MT5 database tables1--15 minutesLow -- requires database access only

For most brokers, API-based polling at 1-minute intervals provides sufficient accuracy. Real-time plugin integration is typically reserved for brokers with high-frequency trading volume where IBs expect live commission updates in their portal. Database sync is the simplest approach but introduces the highest latency and does not scale well across multiple MT4/MT5 servers.

When integrating with MT4/MT5, map every trading account to its referring IB at the account creation level, not at the trade level. This prevents attribution gaps when traders open multiple accounts or when the IB relationship is established after the first trade. The IB-to-account mapping should be immutable once set.

Automating Payout Workflows

Manual payout processing works when you have 20 IBs. At 200 IBs with multi-tier cascades, manual processing takes days and introduces errors. An automated payout workflow follows a predictable cycle: commission calculation, qualification filtering, approval, and disbursement.

  • Daily: commissions calculated automatically from trade data -- visible to IBs in their portal as pending earnings
  • Hold period: commissions held for the configured period (14--30 days) while qualification rules are evaluated
  • Payout generation: at the scheduled payout date, qualified commissions are aggregated into payout batches
  • Approval: payout batches reviewed by the finance team -- flagged exceptions require manual review
  • Disbursement: approved payouts sent via configured payment method (wire, e-wallet, crypto, internal transfer)
  • Reconciliation: payout records matched against bank statements and payment provider confirmations

Handling Multi-Currency IB Payouts

Forex brokers operate globally, and IBs expect payouts in their local currency. A broker might calculate commissions in USD (based on lot values) but pay an IB in EUR, another in MYR, and a third in BTC. The currency conversion point matters: converting at the time of the trade versus at the time of payout can create 2--5% differences on volatile months.

Standard practice is to calculate all commissions in the broker base currency (usually USD) and convert at the daily rate on the payout date. This is transparent, auditable, and avoids mid-month conversion disputes. Document the conversion method in the IB agreement and display both the base currency amount and the converted amount in the IB portal.

For brokers processing more than 100 IB payouts per month across multiple currencies, batch payouts by currency before sending to the payment processor. This reduces transaction fees (one bulk wire in EUR is cheaper than 30 individual transfers) and simplifies bank reconciliation.

Key Takeaways

  • Maintain 3--5 deal templates covering standard tiers and reserve custom deals for top-performing IBs only
  • API-based polling at 1-minute intervals from MT4/MT5 provides sufficient accuracy for most brokers
  • Map IB-to-account attribution at the account creation level, not the trade level, to prevent attribution gaps
  • Automate the full payout cycle: calculation, hold period, qualification, approval, disbursement, reconciliation
  • Calculate commissions in the broker base currency and convert at the daily rate on payout date for transparency