Payment ReconcilerDocumentation

QFind anything/

List incoming transactions

Lists incoming transactions with optional filters. Returns an array of IncomingTransaction objects.

Parameters

limit(number)

Maximum number of items to return. Default: 20.

offset(number)

Number of items to skip for pagination.

status(string)

Filter by status (PENDING, MATCHED, UNMATCHED).

source(string)

Filter by source (manual, stripe, csv, ebics).

fromDate(string)

Filter transactions from this date (YYYY-MM-DD).

toDate(string)

Filter transactions to this date (YYYY-MM-DD).

GET/incoming-transactions

curl -X GET "http://localhost:8000/api/v1/incoming-transactions?limit=20&offset=0" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Tenant-Id: $TENANT_ID" \
  -H "X-Environment: production"

Response

[
  {
    "id": "tran_inc_acme_2Kp1GH0SLIjDWdEL",
    "tenantId": "tenant_abc123",
    "environment": "production",
    "merchant": "Amazon Web Services",
    "amount": 300,
    "direction": "CREDIT",
    "currency": "USD",
    "transactionDate": "2024-01-15",
    "reference": "TXN-2024-001",
    "description": "AWS monthly infrastructure charge",
    "source": "stripe",
    "status": "PENDING",
    "createdAt": "2024-01-15T10:30:00.000Z",
    "updatedAt": "2024-01-15T10:30:00.000Z"
  }
]