Reconciliation

Instant reconciliation

Run instant reconciliation with the Python SDK.

POST/reconciliation/start-instant

Use blnk.reconciliation.run_instant to reconcile external records inline.

Call the method

response = blnk.reconciliation.run_instant({
  "external_transactions": [
    {
      "id": "txn_1",
      "amount": 5.49,
      "reference": "INV-2023-002",
      "currency": "GBP",
      "description": "Card payment",
      "date": "2024-11-15T14:25:30Z",
      "source": "bank-api",
    },
  ],
  "strategy": "one_to_one",
  "dry_run": True,
  "matching_rule_ids": [
    "rule_890bdbc4-467f-4670-8424-5667e41daf29",
  ],
})

Field	Type	Description
`external_transactions`	`list[dict]`	Array of external transaction rows to reconcile.
`external_transactions.` `[].id`	`str`	Unique external transaction ID.
`external_transactions.` `[].amount`	`number`	Transaction amount.
`external_transactions.` `[].reference`	`str`	Unique transaction reference.
`external_transactions.` `[].currency`	`str`	ISO 4217 currency code.
`external_transactions.` `[].description`	`str`	Description of the transaction.
`external_transactions.` `[].date`	`str`	Transaction date and time.
`external_transactions.` `[].source`	`str`	Origin of the transaction data.
`strategy`	`str`	Match strategy: `one_to_one`, `one_to_many`, or `many_to_one`.
`matching_rule_ids`	`string[]`	IDs of the matching rules to apply.

Optional parameters

Field	Type	Description
`dry_run`	`bool`	Set `True` to test without writing results to the ledger.
`grouping_criteria`	`str`	Field used to group records during matching.

Save the reconciliation ID

Use response.data["reconciliation_id"] with blnk.reconciliation.get to poll status and match counts.

Response

{
  "reconciliation_id": "rec_a8f2c91d-1234-4abc-9def-0123456789ab"
}

Field	Type	Description
`reconciliation_id`	`str`	ID of the reconciliation run. Use it with `blnk.` `reconciliation.get` to check status.