Skip to main content
​
Sep 24, 2026
blnk-python@1.5.0 targets Blnk Core 0.15.4.

​
Transactions

A second refund of the same transaction is rejected instead of reversing the first. A source or destination that does not exist is reported as a missing balance, not a missing transaction. A split cannot include both sources and destinations. See the 0.15.4 migration guide.

​
Ledgers

List ledgers, balances, and transactions. List the monitors on one balance with balance_monitor.list_by_balance_id.

​
Error handling

Named codes for the full Core catalogue are on BlnkErrorCode. Branch on response.error.code. See API error codes.

​
Before you upgrade

  • You need Core 0.15.4 for these features.
​
Sep 3, 2026
blnk-python@1.4.0 targets Blnk Core 0.15.3.

​
Transactions

Preview a create, bulk, refund, or inflight update without writing anything. Pass dry_run: True and Core returns whether it would apply and how balances would change. The reference is still free to use on a real post. See Dry-run transactions.Refunds can take a description and metadata. An empty description inherits the original. Metadata is merged onto the inherited copy.

​
Balances

Create a General Ledger balance yourself by passing an @ indicator with ledger_id set to general_ledger_id. See Internal balances.

​
Hooks

Listing hooks without a type now returns PRE and POST hooks.

​
Error handling

Named codes for invalid amounts, validation failures, and General Ledger conflicts are on BlnkErrorCode. Branch on response.error.code.

​
Before you upgrade

  • You need Core 0.15.3 for these features.
  • A preview that would be rejected is still HTTP 200. Check would_apply before you treat the call as a posted transaction.
​
Jul 8, 2026
blnk-python@1.3.0 covers Blnk Core 0.15.0.
Initial public release of the Python SDK with full parity against the TypeScript SDK.

​
Coverage

Ledgers, ledger balances (including monitors, snapshots, historical balances, and lineage), transactions (bulk, inflight, refunds, queue recovery), reconciliation, identities and PII tokenization, search and reindex, metadata, hooks, API keys, and system health.

​
Client

Sync client built on requests with configurable timeouts, GET-only retries, structured ApiResponse envelopes, and redacted logging.

​
Core 0.15.0

Structured error codes on response.error.code. Inflight commit and void run through the queue by default; pass skip_queue for synchronous results.

​
Before you upgrade Core

Note the following breaking changes in Core 0.15.0:
  • Transaction and balance responses no longer include rate or currency_multiplier.
  • Branch on response.error.code for Core failures. Do not parse error message text.