Conciliation

Use these endpoints to inspect the payments Reconbanker is currently tracking, re-run the matching engine on demand, replay webhook deliveries, and force a fresh poll of your pending orders endpoint. All endpoints require Authorization: Bearer <jwt>.

List conciliation requests

Use this endpoint to list payment requests across all your accounts. Optionally filter by status.

GET /conciliation?limit=50&offset=0&status=pending

Query parameters:

• limit - defaults to 50.
• offset - defaults to 0.
• status - optional. One of pending, processing, matched, ambiguous, not_found, expired, cancelled, failed.

Response 200 OK:

[
  {
    "id": "uuid",
    "account_id": "uuid",
    "external_id": "ORD-1234",
    "status": "pending",
    "amount": "1500.00",
    "currency": "UYU",
    "sender_name": "ACME SA",
    "created_at": "2026-05-12T10:00:00Z",
    "bank": "itau",
    "account_name": "Operating account"
  }
]

Newest first.

Get one conciliation request

Use this endpoint to fetch a single request with every match attempt Reconbanker has run for it and, if available, the bank transaction it was matched against.

GET /conciliation/:requestId

Response 200 OK:

{
  "id": "uuid",
  "account_id": "uuid",
  "external_id": "ORD-1234",
  "status": "matched",
  "amount": "1500.00",
  "currency": "UYU",
  "sender_name": "ACME SA",
  "created_at": "2026-05-12T10:00:00Z",
  "bank": "itau",
  "account_name": "Operating account",
  "attempts": [
    {
      "id": "uuid",
      "request_id": "uuid",
      "attempt_number": 1,
      "result": "matched",
      "reason": null,
      "created_at": "2026-05-12T10:05:00Z"
    }
  ],
  "match": {
    "id": "uuid",
    "request_id": "uuid",
    "bank_transaction_id": "uuid",
    "is_primary": true,
    "amount": "1500.00",
    "currency": "UYU",
    "sender_name": "ACME SA",
    "received_at": "2026-05-12T10:03:00Z"
  }
}

match is null when the request is not yet matched.

Responses:

• 200 OK
• 404 Not Found - { "error": "Not found" }

Re-run matching for a request

Use this endpoint to force Reconbanker to run the matching engine again on a specific request. This is useful after a new bank transaction has been ingested.

POST /conciliation/:requestId/run

Response 202 Accepted:

{ "queued": true }

Resend a webhook

Use this endpoint to replay the webhook for a specific request. Useful when your server was down during the original delivery.

POST /conciliation/:requestId/notify

Response 202 Accepted:

{ "queued": true }

Poll pending orders now

Use this endpoint to force Reconbanker to call your pending_orders_endpoint immediately instead of waiting for the next scheduled poll.

POST /conciliation/poll/:accountId

Response 202 Accepted:

{ "queued": true }

See Accounts for the settings that control polling and webhooks.