> ## Documentation Index
> Fetch the complete documentation index at: https://developers-sandbox.uqpaytech.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Client releases

> Current UQPAY SDK and CLI versions, release notes, and versioning guidance.

Use this page to find the current stable release for each UQPAY SDK and the UQPAY CLI.

> [!NOTE]
>
> SDK and CLI versions are independent from the Gateway API documentation version. For example, an SDK `3.1.x` release does not correspond to Gateway API docs `v1.6`.

## Current stable releases

Use the version shown for your client and review its migration requirements before upgrading.

| Client | Current stable | Install or download | Release notes |
| - | - | - | - |
| Node.js | `3.1.0` | `npm install @uqpay/sdk@3.1.0` | [Node.js changelog for v3.1.0](https://github.com/uqpay/uqpay-node/blob/e282972f36919d3d14f6bd8398ccf218bc481b57/CHANGELOG.md#310) |
| Python | `3.1.0` | `pip install --upgrade uqpay==3.1.0` | [Python changelog for v3.1.0](https://github.com/uqpay/uqpay-sdk-python/blob/2ee2efec53efa2c73be790298e462164423bad4f/CHANGELOG.md#310) |
| Go | `3.1.0` | `go get github.com/uqpay/uqpay-sdk-go/v3@v3.1.0 && go mod tidy` | [Go v3.1.0 release](https://github.com/uqpay/uqpay-sdk-go/releases/tag/v3.1.0) |
| Java | `3.1.0` | [Download the v3.1.0 release JAR](https://github.com/uqpay/uqpay-sdk-java/releases/tag/v3.1.0) | [Java v3.1.0 release](https://github.com/uqpay/uqpay-sdk-java/releases/tag/v3.1.0) |
| CLI | `3.1.0` | `npm install -g @uqpay/cli@3.1.0` | [CLI changelog for v3.1.0](https://github.com/uqpay/uqpay-cli/blob/682795c8a5b6d75bba3b42268faca127622894cb/CHANGELOG.md#310) |

> [!WARNING]
>
> The Java SDK is distributed as a thin JAR through GitHub Releases. It is not published to Maven Central, and your application must declare its runtime dependencies.

## Release history

### SDK and CLI v3.1.0

Version `3.1.0` aligns PIN management, RFI answers, beneficiary checks, simulated deposits, and response/Webhook models across Node.js, Python, Go, Java, and CLI. It retains the full functionality originally published as 4.0.0 under a corrected version number. Review the migration requirements when upgrading from 3.0.0.

| Area | Migration requirement |
| - | - |
| PIN management | On the unified PIN endpoint, omitted `type` means initial `SET`. Use explicit `RESET` without the current PIN, or `UPDATE` with six-digit `old_pin`. An accepted request is not a completed PIN operation; query `card_order_id`. |
| RFI | Send the full prefixed `rfi_id`. Request attachments are uploaded file IDs; response attachments are file-detail objects. Update code using typed response models. |
| Simulated deposits | Supply `account_id` explicitly. This API is Sandbox-only. |
| Beneficiary checks | Supply at least one non-empty `account_number` or `iban`. |
| Go | Use `/v3`; existing 3.0.0 integrations keep their import paths. Change `/v4` imports to `/v3` if applicable, then run `go mod tidy`. |
| Java | Continue using the GitHub Release JAR with its runtime dependencies; Maven Central is not available. |

See the versioned migration notes for [Node.js](https://github.com/uqpay/uqpay-node/blob/e282972f36919d3d14f6bd8398ccf218bc481b57/CONTRACT_ALIGNMENT.md), [Python](https://github.com/uqpay/uqpay-sdk-python/blob/2ee2efec53efa2c73be790298e462164423bad4f/CONTRACT_ALIGNMENT.md), [Go](https://github.com/uqpay/uqpay-sdk-go/blob/f631f53fcf657b1d37ec9f1e1389f0c7a9337d98/CONTRACT_ALIGNMENT.md), [Java](https://github.com/uqpay/uqpay-sdk-java/blob/af741966c9a1e28e74783acd0dfb6f9857278c51/CONTRACT_ALIGNMENT.md), and [CLI](https://github.com/uqpay/uqpay-cli/blob/682795c8a5b6d75bba3b42268faca127622894cb/CONTRACT_ALIGNMENT.md).

This release does not add the newer pre-authorization capture request fields or CARD/Mastercard Send beneficiary types. Check the relevant API reference when integrating those capabilities.

### SDK and CLI v3.0.0

Version `3.0.0` aligns the typed `COMPANY` Create SubAccount request models with the Account Center contract effective on 2026-09-17. The affected representative and `business_details` fields are required, and the removed company `account_purpose` values are no longer accepted. The Go module and import path now use `github.com/uqpay/uqpay-sdk-go/v3`.

See the [2026-09-17 platform changelog entry](https://developers-sandbox.uqpaytech.com/docs/changelog#2026-09-17) for the affected fields, supported values, and migration requirements.

### SDK and CLI v2.1.0

Version `2.1.0` lets `COMPANY` Create SubAccount requests omit `ownership_details.representatives[].date_of_birth`. When supplied, the value must remain a `YYYY-MM-DD` date. `INDIVIDUAL` requests still require `individual_info.date_of_birth`.

This is a compatible change. Existing integrations that send a valid representative date of birth do not need to change. See the [2026-08-26 platform changelog entry](https://developers-sandbox.uqpaytech.com/docs/changelog#2026-08-26) for the API contract.

### SDK and CLI v2.0.0

Version `2.0.0` adds support for the Virtual Account application contract across Node.js, Python, Go, Java, and CLI. For Go, the module and import path now use `github.com/uqpay/uqpay-sdk-go/v2`.

See the [2026-09-03 platform changelog entry](https://developers-sandbox.uqpaytech.com/docs/changelog#2026-09-03) for upgrade commands and the Virtual Account migration path.

### Go v1.2.1

Go `v1.2.1` adds support for PGP authorization decisions.

This SDK release does not change the Gateway API documentation version. See the [Go v1.2.1 release notes](https://github.com/uqpay/uqpay-sdk-go/releases/tag/v1.2.1) for details.

### SDK and CLI v1.2.0

Version `1.2.0` was the first `1.x` release available across Node.js, Python, Go, Java, and CLI.

See the [2026-08-04 platform changelog entry](https://developers-sandbox.uqpaytech.com/docs/changelog#2026-08-04) for upgrade commands, runtime requirements, and the original announcement.

## Where changes are recorded

* Use the release-notes link in the table for changes specific to one SDK or the CLI.
* Use the [Platform and Gateway API changelog](https://developers-sandbox.uqpaytech.com/docs/changelog) for API, platform, and documentation changes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.