Resources

AN OPERATOR’S GUIDE

Lottery Affiliate and Agent Management: Attribution, Commission and Settlement

Lottery affiliate management and agent management solve different operating problems. Affiliates refer customers and receive compensation under a marketing agreement. Retail agents sell through an authorised channel and may also have settlement obligations. Putting both into one commission field makes attribution, finance and dispute handling harder.

An operator should define channel rules before choosing software. This guide explains the records, permissions and acceptance tests to evaluate, with platform cost and operating responsibilities kept separate from the commercial terms agreed with partners.

Separate attribution, commission and settlement

Attribution identifies the partner connected to a qualifying event. Commission calculates what the operator owes under the relevant agreement. Settlement records payment or other financial obligations. These are related processes, but they are not interchangeable.

Define whether eligibility depends on registration, an accepted ticket, completed play or another agreed event. Document exclusions, reversals, attribution windows, currency, rounding and when commission becomes payable. Version the rules with an effective date. A new agreement should not silently rewrite previously approved statements.

For agents, distinguish commission from cash collection, working balances and amounts due to the operator. Keep player balances separate from partner accounts.

Build a role and channel responsibility matrix

Example lottery affiliate and agent operating matrix
RoleRelevant recordFinancial basisRequired control
AffiliateReferral and qualifying eventAgreed acquisition or revenue-based commissionAttribution evidence and adjustment history
Retail agentAccepted channel saleSales commission and separate settlement obligationsTerminal identity and daily reconciliation
Sub-agentApproved parent and sales assignmentContracted allocation within the hierarchyNo orphan accounts or double counting
Finance administratorApproved partner statementRecorded payable and payment referenceApproval permissions and audit trail
Technical integrationEvent and external referenceNo independent commission entitlementRestricted access and replay protection

In a retail-to-online operating model, specify whether online activity belongs to a referral partner, an agent channel or neither. Do not allow overlapping rules to produce duplicate compensation without an explicit agreement.

Scenario: an attributed ticket is later refunded

A referred player buys a ticket. The purchase becomes a qualifying event, but the draw is subsequently cancelled and the ticket refunded. Request a demonstration of the entire adjustment path:

  1. The original event remains linked to its referral, ticket and commission calculation.
  2. The refund creates an adjustment under the applicable agreement, not an unexplained deletion of the event.
  3. A repeated refund notification cannot reverse the same commission twice.
  4. The next partner statement explains whether the adjustment affects a pending amount or a previously settled period.

Repeat the test when a player is associated with both an affiliate referral and a retail agent. The system should apply the operator’s documented priority or allocation rule and preserve the decision.

Acceptance tests for partner management

  • A replayed registration, sale or refund event cannot produce duplicate commission.
  • A commission rule change has a visible version and effective date.
  • A partner cannot view another partner’s customers, statements or exports.
  • A sub-agent’s reassignment preserves earlier hierarchy and settlement history.
  • Finance can reconcile statement totals to eligible events, adjustments and recorded payments.

Address partner visibility, retention and export boundaries in the data ownership requirements. Partners do not need unrestricted access to player profiles to verify a commission statement. Define the minimum necessary fields and applicable consent requirements.

Use the affiliate growth and fraud-risk guide to prepare the acquisition-channel questions for these acceptance tests.

Specify reporting and integration evidence

Ask for a statement that separates eligible volume, commission, adjustments, payable balance and paid amounts. Agents additionally need channel settlement and discrepancy reports. Connect reconciliation to the payment architecture, and document partner IDs, event references and delivery behaviour in the API integration brief.

Include these scenarios in the provider evaluation checklist. A dashboard showing total sales is not enough to establish that attribution, commission and settlement agree.

Design a retailer and distributor network, not another affiliate tier

An online affiliate referral is not a retail outlet, and a distributor managing several outlets is not simply an affiliate with a larger commission. Define the operating unit for each relationship: legal partner, outlet, terminal and responsible settlement account. Record which unit sells, which collects money, which supports the customer and which settles with the operator. A distributor’s place in the hierarchy does not, by itself, establish responsibility for every outlet’s obligations.

Use the retail and online architecture guide to define channel boundaries, then the lottery POS integration guide for terminal and sale records. Assign outlet and terminal identifiers that remain traceable when an outlet changes distributor or a device is replaced. The network needs a documented opening and closing process, not only a referral dashboard.

Turn working balances and sales limits into testable controls

Specify whether the agreed channel arrangement requires funding before sales or permits sales against an approved limit. This is an operating requirement to confirm, not a recommendation of either commercial model. Define who approves funding, limit changes and temporary overrides, and what stops a sale when the available authority is exhausted. An unconfirmed top-up should not appear as cleared funds merely because an agent submitted a receipt.

Keep pending terminal activity visible when calculating available sales authority. Reconnection must not silently reset a limit or count the same accepted sale twice. Document message references and uncertain outcomes in the API integration requirements; do not assume a terminal can sell offline unless the supported workflow and responsibility have been demonstrated.

Evidence to request across an agent’s operating day
Operating stepControl to agreeDemonstration evidence
Opening and fundingConfirmed opening balance and funding approvalAn unconfirmed funding request remains separate from available sales authority.
Accepted saleOutlet, terminal, ticket and balance referencesThe sale can be traced from the terminal record to the correct settlement account.
Limit reachedSale decision and authorised override ownerThe documented limit blocks or routes the sale without an unexplained balance reset.
Terminal reconnectionPending activity and synchronisation outcomePreviously accepted sales remain counted and uncertain requests remain visible.
Daily closeClosing declaration, collection and outstanding itemsThe agreed day’s records explain the closing balance and every unresolved discrepancy.

Close the agent day without hiding disputed items

Agree the reporting cut-off and how late records enter the next reconciliation. When an agent disputes a closing balance or commission line, create a case linked to the outlet, period and affected references. Give it an owner, evidence request and decision record. Separate disputed amounts from undisputed items; their payment treatment should follow the agreed terms, not an unexplained dashboard adjustment.

Track unresolved closing discrepancies and their age through the operator KPI framework. Let agents see the evidence needed to question their own statement without exposing other outlets’ customer records; scope that access in the data ownership and export requirements. Include a disputed close, rejected top-up and exhausted-limit sale in UAT acceptance.

Bring your outlet structure, funding arrangements and closing process to WhiteLotto. CONTACT to discuss the agent-management scope and the operating evidence to request.

Lottery affiliate and agent management FAQ

Should affiliates and agents use the same rules?

Not automatically. Their roles, eligible events and financial responsibilities differ. Shared reporting can be useful without merging their agreements.

Is revenue share the only commission model?

No. Agreements may use acquisition, sales or other defined bases. The software must represent the actual calculation and exclusions rather than assuming one universal formula.

What happens when a partner relationship ends?

Define access withdrawal, final statements, outstanding obligations and record retention. Ending access should not erase historical reconciliation evidence.

What should a partner-management demo prove?

Attribution, a rule-based calculation, a refund adjustment, a role-restricted statement and a reconciled settlement.

Discuss your channel requirements

Prepare your partner types, compensation agreements, channel structure and reporting needs. CONTACT WhiteLotto to discuss requirements for affiliate and agent workflows and the questions to test with a platform provider.

Wojciech Lysak is the Managing Director of WhiteLotto.com. LinkedIn