> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payreque.st/llms.txt
> Use this file to discover all available pages before exploring further.

# Sync Problems

> Resolving data synchronization

# Sync Problems

PayRequest keeps a local copy of data from connected providers (Mollie, PayPal) so your dashboard loads fast. Most of the time this happens automatically in the background, but if something looks out of date — a transaction stuck as "pending" when it was actually paid, or a subscription missing from your list — most areas that pull from an external provider have a manual sync action you can trigger yourself.

<Info>
  Sync problems are almost always about one connected provider's data lagging behind, not about PayRequest's own core records (invoices, customers, orders), which are updated directly and don't need "syncing."
</Info>

## Signs You Might Have a Sync Problem

* A transaction's status in PayRequest doesn't match what you see in your Mollie or PayPal dashboard
* The Transactions page shows a **"Sync gap detected"** banner
* A subscription, customer, or mandate that exists in your provider account doesn't show up in PayRequest

## Manual Sync Actions

These are available directly on the relevant page:

| Where | Action | What it does |
| - | - | - |
| **Mollie Transactions** page | **Fill Gap** | Appears when a gap is detected between your last full sync and your most recent transactions; re-syncs the missing range |
| **Mollie Transactions** page | **Reset Sync** | Clears a sync that appears stuck, so you can retry |
| A single transaction's detail page | **Sync with Mollie** / **Sync with PayPal** | Re-fetches that one transaction's current status directly from the provider |
| **Mollie Customers** page | **Sync Customers** | Pulls customer records from Mollie |
| **Mollie Subscriptions** page | **Sync Subscriptions** | Pulls subscription records from Mollie |
| **Mollie Chargebacks** page | **Sync Chargebacks** | Pulls chargeback records from Mollie |
| A mandate's detail page | **Re-Sync Mandate** | Re-fetches that mandate's current status from Mollie |
| Mollie connection settings | **Sync Now** | Kicks off a background sync of your Mollie customers after (re)connecting |

<Tip>
  If the **Mollie Transactions** page shows "Sync in progress," it's importing transactions in the background and will update automatically — you don't need to do anything unless it looks stuck, in which case use **Reset Sync**.
</Tip>

## The "Sync Gap Detected" Banner

This appears on the Mollie Transactions page when PayRequest notices your last full sync happened a while ago, but you have transactions from more recently than that — meaning there could be transactions in between that were never pulled in. Click **Fill Gap** to sync that specific date range.

## Why Sync Can Lag

* The webhook from your provider didn't arrive or was delayed (see [Webhook Configuration](/organization-and-automation/webhook-configuration) if you're troubleshooting your own outgoing webhook — this is about PayRequest's *incoming* sync with Mollie/PayPal, which is separate)
* A background sync job is still running for a large account
* The provider connection needs to be re-authorized (check your provider connection status in Settings)

## FAQ

<AccordionGroup>
  <Accordion title="I clicked a sync button and nothing changed. What now?">
    Give it a minute — most syncs run in the background and the page updates once complete. If a transaction-level sync (e.g. "Sync with Mollie") still shows stale data after that, double-check the same payment's status directly in your Mollie dashboard; if Mollie itself shows the old status, PayRequest is correctly reflecting it.
  </Accordion>

  <Accordion title="Should I use Fill Gap or Reset Sync?">
    Use **Fill Gap** when you suspect specific transactions are missing (the gap banner will tell you this). Use **Reset Sync** only if a sync appears stuck/in-progress for an unreasonably long time and you need to clear it before retrying.
  </Accordion>

  <Accordion title="Does a sync problem mean I lost data?">
    No — your provider (Mollie/PayPal) remains the source of truth for what actually happened with a payment. A sync problem just means PayRequest's local copy hasn't caught up yet; running the relevant sync action pulls the current state back in.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Payment Failures" icon="exclamation-triangle" href="/troubleshooting/payment-failures">
    Diagnose a specific declined or stuck payment
  </Card>

  <Card title="Webhook Configuration" icon="webhook" href="/organization-and-automation/webhook-configuration">
    Your own outgoing payment notifications, separate from provider sync
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.