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.
Migration
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.
Built for operating reality
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.
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.
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
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
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
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.
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.
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