Migration

Move a live programme without losing the attribution history.

Migrating an affiliate programme is mostly an identity problem. Keep affiliates paid, keep existing attributions intact and keep the evidence behind historical commissions, then move the new activity.

01ReferralLink or code
02ConversionStable event
03CommissionRule evidence
Stable identitiesDual-run windowRetained evidence

Built for operating reality

Clear contracts at every boundary.

01

Map identities before anything else

Affiliates, referral codes, customers and transactions each need a stable external identifier on both sides. Everything else in a migration is downstream of that mapping being right.

02

Run both for one full cycle

Record new conversions in both systems for a complete billing and refund cycle, then reconcile. Discrepancies found during a dual run are cheap; the same discrepancies found after cutover are disputes with affiliates.

03

Do not migrate money, migrate evidence

Historical commissions should be imported with the basis and rule that produced them, not recalculated under new rules. Recalculating changes numbers affiliates have already been paid against.

Sequence

Cut over intake before you cut over payouts.

Move conversion recording first and leave payouts on the existing system until a full cycle has reconciled. Intake is reversible in a way that a settled payout is not, so the risky half of the migration should be the last half.

Affiliate experience

An affiliate should not have to notice.

Existing referral codes and links should keep resolving. Reissuing every affiliate a new code turns an internal migration into an external campaign, and the links already published on other people’s sites will not be updated.

Questions, answered

Know where the boundaries are before you integrate.

Will we lose attribution when we migrate?

Not if existing attributions are imported as claims against stable customer identities rather than recreated from tracking data. Attribution that only ever existed as browser state is the part that cannot be moved.

What happens to commissions accrued but not yet paid?

Import them with their original basis and rule evidence and settle them on whichever system owns payouts at that moment. Do not recalculate them under the new rule set.

How long should a dual-run window be?

At least one full billing cycle plus the refund window, so the reconciliation covers a renewal and a reversal rather than only new sales.

Build the reliable path

Make every referral decision traceable from click to payout.

Request sandbox access