Start Here

Java SDK changelog

Latest releases, fixes, and improvements to the Blnk Java SDK.

November 18, 2026

1.7.0

Balance monitors

Set MonitorData.trigger to EDGE or LEVEL. Use updatePartial to change only the monitor fields you provide; this requires Core 0.15.9. Monitor responses include the current condition state and precise threshold.

Transactions and balances

Pass a reference when committing or voiding an inflight transaction to make retries idempotent. Create transactions with a finite, non-negative overdraft limit. Get balances with embedded identity or ledger data through include.

Security and compatibility

Resource IDs used in request paths are validated and escaped before the SDK sends a request.

Before you upgrade

  • Use Core 0.15.9 for partial monitor updates.
  • Keep using com.blnkfinance:blnk-java; change only the version to 1.7.0.

October 3, 2026

1.6.0

Set instanceId on BlnkClientOptions to route requests through Blnk Cloud. Each request includes instance_id. Use the Cloud proxy base URL and a Cloud API key or OAuth token. Leave instanceId unset for direct Core clients. See the Enterprise Proxy documentation.

September 24, 2026

1.5.0

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 balanceMonitor().listByBalanceId().

Error handling

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

Before you upgrade

  • You need Core 0.15.4 for these features.
  • Keep using com.blnkfinance:blnk-java. Change only the version to 1.5.0.

September 4, 2026

1.4.0

Transactions

Preview a create, bulk, refund, or inflight update without writing anything. Call dryRun(true) on the request. 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 ledgerId 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 and General Ledger conflicts are on BlnkErrorCodes. Branch on response.error().code().

Before you upgrade

  • You need Core 0.15.3 for these features.
  • Keep using com.blnkfinance:blnk-java. Change only the version to 1.4.0.

July 8, 2026

1.3.0

Initial public release of the Java 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 the JDK java.net.http.HttpClient and Jackson, with Blnk.init / BlnkClientOptions.builder(), configurable timeouts, GET-only retries, structured ApiResponse envelopes, and redacted logging. Services use camelCase accessors such as transactions().create() and fluent request builders in com.blnkfinance.blnk.types.

Core 0.15.0

Structured error codes on response.error().code(). Inflight commit and void run through the queue by default; pass skipQueue 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.