> ## 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.

# 客户端发布

> 查看UQPAY SDK与CLI的当前版本、发布说明和版本规则。

通过本页查看各款UQPAY SDK与UQPAY CLI的当前稳定版本。

> [!NOTE]
>
> SDK和CLI版本独立于Gateway API文档版本。例如，SDK `3.1.x`与Gateway API文档`v1.6`没有版本号对应关系。

## 当前稳定版本

请以表中对应客户端的版本为准，并在升级前检查迁移要求。

| 客户端 | 当前稳定版 | 安装或下载 | 发布说明 |
| - | - | - | - |
| Node.js | `3.1.0` | `npm install @uqpay/sdk@3.1.0` | [Node.js v3.1.0 Changelog](https://github.com/uqpay/uqpay-node/blob/e282972f36919d3d14f6bd8398ccf218bc481b57/CHANGELOG.md#310) |
| Python | `3.1.0` | `pip install --upgrade uqpay==3.1.0` | [Python v3.1.0 Changelog](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` | [下载 v3.1.0 发布版 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 v3.1.0 Changelog](https://github.com/uqpay/uqpay-cli/blob/682795c8a5b6d75bba3b42268faca127622894cb/CHANGELOG.md#310) |

> [!WARNING]
>
> Java SDK以thin JAR形式通过GitHub Releases分发，尚未发布到Maven Central。你的应用必须自行声明其运行时依赖。

## 发布历史

### SDK和CLI v3.1.0

`3.1.0`统一适配Node.js、Python、Go、Java和CLI的PIN管理、RFI回答、收款人校验、模拟入账及响应/Webhook模型。本次将原4.0.0的版本号调整为3.1.0，完整保留其功能。从3.0.0升级仍需检查以下迁移要求。

| 范围 | 迁移要求 |
| - | - |
| PIN管理 | 统一PIN接口省略`type`表示首次`SET`。无需当前PIN的重置应显式传`RESET`；验证旧PIN后修改应使用`UPDATE`并传六位`old_pin`。请求受理不代表操作完成，需通过`card_order_id`查询终态。 |
| RFI | 发送包含前缀的完整`rfi_id`。请求附件为上传文件ID，响应附件为文件详情对象；使用强类型响应模型的代码需同步调整。 |
| 模拟入账 | 显式传入`account_id`；此接口仅用于Sandbox。 |
| 收款人校验 | `account_number`和`iban`至少提供一个非空值。 |
| Go | 使用`/v3`；已有3.0.0集成无需修改import路径。如使用了`/v4`，改为`/v3`后运行`go mod tidy`。 |
| Java | 继续从GitHub Release下载JAR并配置运行时依赖；不通过Maven Central分发。 |

详见各版本的迁移说明：[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)、[CLI](https://github.com/uqpay/uqpay-cli/blob/682795c8a5b6d75bba3b42268faca127622894cb/CONTRACT_ALIGNMENT.md)。

本次发布未新增后续的预授权请款请求字段或CARD/Mastercard Send收款人类型；接入这些能力时请核对对应API文档。

### SDK与CLI v3.0.0

`3.0.0`使`COMPANY`类型的Create SubAccount请求模型与2026-09-17生效的Account Center合同保持一致。受影响的代表人字段和`business_details`字段均为必填，已移除的公司`account_purpose`枚举值不再支持。Go的module与import path现使用`github.com/uqpay/uqpay-sdk-go/v3`。

受影响字段、支持的枚举值和迁移要求请参阅[2026-09-17平台更新日志](https://developers-sandbox.uqpaytech.com/docs/zh/changelog#2026-09-17)。

### SDK与CLI v2.1.0

`2.1.0`允许`COMPANY`类型的Create SubAccount请求省略`ownership_details.representatives[].date_of_birth`。若提供该字段，其值仍须为`YYYY-MM-DD`格式的日期。`INDIVIDUAL`请求仍须提供`individual_info.date_of_birth`。

这是一项兼容性变更。现有集成如已传入有效的代表人出生日期，无需修改。API合同请参阅[2026-08-26平台更新日志](https://developers-sandbox.uqpaytech.com/docs/zh/changelog#2026-08-26)。

### SDK与CLI v2.0.0

`2.0.0`为Node.js、Python、Go、Java和CLI增加了虚拟账户申请合同支持。Go的module与import path现使用`github.com/uqpay/uqpay-sdk-go/v2`。

升级命令和虚拟账户迁移路径请参阅[2026-09-03平台更新日志](https://developers-sandbox.uqpaytech.com/docs/zh/changelog#2026-09-03)。

### Go v1.2.1

Go `v1.2.1`增加了PGP授权决策支持。

本次SDK发布不改变Gateway API文档版本。详情请参阅[Go v1.2.1发布说明](https://github.com/uqpay/uqpay-sdk-go/releases/tag/v1.2.1)。

### SDK与CLI v1.2.0

`1.2.0`是Node.js、Python、Go、Java和CLI首次均提供`1.x`版本的发布。

升级命令、运行环境要求和原始公告请参阅[2026-08-04平台更新日志](https://developers-sandbox.uqpaytech.com/docs/zh/changelog#2026-08-04)。

## 各类变更记录的位置

* 通过表中的发布说明链接查看某款SDK或CLI的具体变化。
* 通过[Platform与Gateway API更新日志](https://developers-sandbox.uqpaytech.com/docs/zh/changelog)查看API、平台和文档变化。


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