SDK和CLI版本独立于Gateway API文档版本。例如,SDK
3.1.x与Gateway API文档v1.6没有版本号对应关系。当前稳定版本
请以表中对应客户端的版本为准,并在升级前检查迁移要求。发布历史
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升级仍需检查以下迁移要求。
详见各版本的迁移说明:Node.js、Python、Go、Java、CLI。
本次发布未新增后续的预授权请款请求字段或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平台更新日志。
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平台更新日志。
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平台更新日志。
Go v1.2.1
Gov1.2.1增加了PGP授权决策支持。
本次SDK发布不改变Gateway API文档版本。详情请参阅Go v1.2.1发布说明。
SDK与CLI v1.2.0
1.2.0是Node.js、Python、Go、Java和CLI首次均提供1.x版本的发布。
升级命令、运行环境要求和原始公告请参阅2026-08-04平台更新日志。
各类变更记录的位置
- 通过表中的发布说明链接查看某款SDK或CLI的具体变化。
- 通过Platform与Gateway API更新日志查看API、平台和文档变化。

