Operating

Reconciliation Configuration

Configure reconciliation strategy, progress updates, and retries in Blnk.

This page covers the settings that control how Blnk runs reconciliation jobs and reports progress.

Reconciliation settings

Use these settings to configure the default reconciliation strategy, progress updates, and retry behavior.

BLNK_RECONCILIATION_DEFAULT_STRATEGY=one_to_one
BLNK_RECONCILIATION_PROGRESS_INTERVAL=100
BLNK_RECONCILIATION_MAX_RETRIES=3
BLNK_RECONCILIATION_RETRY_DELAY=5s

{
  "reconciliation": {
    "default_strategy": "one_to_one",
    "progress_interval": 100,
    "max_retries": 3,
    "retry_delay": 5
  }
}

BLNK_RECONCILIATION_DEFAULT_STRATEGYdefault one_to_one

Default matching strategy used for reconciliation.

BLNK_RECONCILIATION_PROGRESS_INTERVALdefault 100

Number of records Blnk processes before it emits a progress update.

BLNK_RECONCILIATION_MAX_RETRIESdefault 3

Maximum number of retry attempts for failed reconciliation work.

BLNK_RECONCILIATION_RETRY_DELAYdefault 5s

Time Blnk waits before retrying failed reconciliation work.

`BLNK_RECONCILIATION_DEFAULT_STRATEGY`

This sets the reconciliation strategy Blnk uses by default.

Use one_to_one when one ledger record should match one external record. Change it only when your reconciliation flow regularly needs one-to-many or many-to-one matching.

`BLNK_RECONCILIATION_PROGRESS_INTERVAL`

This controls how often Blnk reports progress while a reconciliation job is running.