ReconbankerReconbanker
Settings

Polling

How often Reconbanker asks your system for new payments, and how to change it.

Polling

In reconcile mode, Reconbanker periodically calls your Pending orders endpoint to fetch the list of payments you are expecting. This page covers what that cadence is and what to do when something goes wrong.

Polling is off when the account is in passthrough mode. Passthrough does not need a list of expected payments.

What "polling" means

Every few minutes, Reconbanker:

  1. Calls the URL you saved as your Pending orders endpoint.
  2. Reads the array of payments your server returns.
  3. Registers any new ones it has not seen before.
  4. Cancels any that have disappeared from your response since the last poll.
  5. Runs a fresh match attempt for each new payment.

This is the loop that keeps Reconbanker in sync with your back office.

Cadence

The default polling interval is every 10 minutes. The interval is not configurable from the dashboard. If you need a different cadence, contact support at ignaciogarcia.code@gmail.com.

What happens when your endpoint is down

If your endpoint returns an error or is unreachable, the polling run is treated as a failure and Reconbanker retries it automatically.

What this means in practice:

  • No data is lost. As soon as your endpoint comes back, the next poll will pick up everything you are returning.
  • You can also force a poll right now by pressing Poll now in the dashboard, or by calling POST /conciliation/poll/:accountId.

What your endpoint must return

See Ingest payments for the JSON shape, the required fields, and idempotency rules.

Tips

  • Keep the response fast. Reconbanker's call should return in under a couple of seconds.
  • Keep the response small. Only return payments that are actually still expected.
  • Returning the same payment again is harmless. Reconbanker dedupes by external_id.

See also