Help Center/Purchases, Rewards & Accumulation/Simulate a reward recalculation (dry run)
Purchases, Rewards & Accumulation•Last updated: 2026-10-20•5 min read

Simulate a reward recalculation (dry run)

Pick a rule version, scope and mode and run "Simulate / Dry Run" to see the differences without writing anything to the ledger.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Open the engine

Open "Network & Compensation" then "Reward Recalculation Engine" (/admin/rewards/recalculation), tab "Recalculation Console".

2

Choose the rule

Under "Target Rule Version" pick a rule; the box shows its Qualifying Basis, Direct Referral Rate, whether duplicate Level-1 is allowed and the calculated entitlement.

3

Choose scope and mode

"Recalculation Scope": All Members (Complete Network), Selected Members (a box appears where you paste member DIDs separated by commas or new lines) or Date Range (From and To date inputs appear; at least one is required). "Execution Mode": Mode B rebuild historical rewards using the selected rule, or Mode A apply the rule by event date. A narrowed scope without its DIDs or dates is refused, never widened to all members.

💡 Pro Tip: The console runs on the reward engine in-memory event store, as the amber notice at the top says; with no events loaded it shows no data yet.
4

Run the dry run

Click "Simulate / Dry Run" (or "Simulate Active Rule" in the header). A summary panel shows existing total, correct total, net adjustment, overpaid or reduced, invalid cash bonus and duplicate L1 negated.

5

See details

Click "View Detailed Differences" to open the differences tab.

Expected Operational Outcome

A simulation summary appears; the ledger is not changed.

Was this guide helpful?

Help us refine our platform documentation