Skip to content
Documentation
All docs

Getting Started

Backfill Progress

The historical-data scoring pass that runs on install. Stages, troubleshooting, and what happens next.

The Backfill Progress page is what you see during your first day with RefundSentry. It tracks the historical-data scoring pass that runs automatically on install, so you can watch each phase complete and know when the dashboard will be populated with real numbers.

Why backfill matters

RefundSentry’s scoring engine is most useful when it has historical context. Backfill pulls your past orders, fulfilments, returns, refunds, and chargebacks — up to 60 days by default, or 12 months if you grant Enhanced Order Access — and scores every event through the same engine that scores new events in real time. By the time backfill finishes, your dashboard has weeks of data and the learning system has a calibrated baseline for your shop.

The seven stages

  1. Orders— Historical Shopify orders pulled and scored. Largest and slowest phase.
  2. Fulfilments— Delivery timestamps per fulfilment, used by the bank-side PNR signal family.
  3. Returns— Native Shopify returns scored.
  4. Refunds— All refund events, including manual refunds that have no associated return.
  5. Chargebacks— Shopify Payments disputes, linked back to the originating order and (when available) return.
  6. Aging inference— Automatic legit-label for old refunds that never produced a chargeback. Closes the outcome feedback loop for the learning system.
  7. Baseline build— Computes per-shop percentiles (return rate, average refund value, etc.) so signals can self-calibrate to your business instead of using global defaults.

Live progress

The stage list polls the server and updates in place. Completed stages show a check; the in-progress stage shows a spinner and a sub-line with the current page or count; pending stages are greyed. A failed stage is shown clearly with a retry link.

If it pauses

  • Auth lost— The Shopify token expired or was revoked. You’ll see an alert with a reconnect link. After reconnect, backfill resumes from the last checkpoint.
  • Rate limit / API hiccup— Backfill auto-retries with exponential backoff and resumes from the last completed page. You don’t need to do anything.

When it finishes

You’re taken to the Insights Welcomepage — a one-shot summary of what RefundSentry found in your historical data. From there the dashboard takes over as your daily home base.

Extending the window

After backfill completes, you can extend the window from 60 days to 12 months (requires Enhanced Order Access) via Settings → Advanced → Backfill. The extension only fetches the gap, so it runs faster than the initial pass.

Next steps