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

# SDK 概览

> 为你的集成选择 UQPAY 官方 SDK 或 UQPAY CLI。

UQPAY提供Node.js、Python、Go和Java官方SDK。UQPAY CLI为命令行与AI Agent工作流提供相同的公开API操作。

`1.2.0`是五个客户端首次协调发布的版本：每个客户端都覆盖同一组公开API操作。后续兼容性修复可能分别递增各客户端的补丁版本，请通过对应的软件包注册表或发布页面确认最新版本。

<h2 id="choose-a-client">
  选择客户端
</h2>

| 客户端     | 运行时                  | 软件包或发布版本                                                                    | 安装命令                                             |
| ------- | -------------------- | --------------------------------------------------------------------------- | ------------------------------------------------ |
| Node.js | Node.js 22+          | [`@uqpay/sdk`](https://www.npmjs.com/package/@uqpay/sdk)                    | `npm install @uqpay/sdk`                         |
| Python  | Python 3.11+         | [`uqpay`](https://pypi.org/project/uqpay/)                                  | `pip install uqpay`                              |
| Go      | Go 1.19+             | [`github.com/uqpay/uqpay-sdk-go/v2`](https://github.com/uqpay/uqpay-sdk-go) | `go get github.com/uqpay/uqpay-sdk-go/v2@latest` |
| Java    | Java 11+             | [GitHub Releases](https://github.com/uqpay/uqpay-sdk-java/releases)         | 下载发布版JAR                                         |
| CLI     | npm安装程序需要Node.js 22+ | [`@uqpay/cli`](https://www.npmjs.com/package/@uqpay/cli)                    | `npm install -g @uqpay/cli`                      |

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

<h2 id="api-coverage">
  API覆盖范围
</h2>

这些客户端为以下产品中的公开可调用操作提供带类型或结构化的访问方式：

* Account Center
* Global Account
* Global Acquiring
* Card Issuance
* Supporting Services

<Note>
  Stablecoin Account（Ramp）不在当前SDK或CLI产品范围内。请直接使用[Stablecoin Account集成指南](/zh/stablecoin-account/v1.6/guide/overview)。
</Note>

<h2 id="common-capabilities">
  通用能力
</h2>

四款语言SDK都会自动获取并缓存UQPAY Access Token，并在当前Token到期前重新获取新Token。它们还支持通过单次请求选项设置幂等键和子账户操作。

其他能力因客户端而异：

| 能力          | Node.js | Python | Go  | Java | CLI   |
| ----------- | ------- | ------ | --- | ---- | ----- |
| 带类型的API资源   | 支持      | 支持     | 支持  | 支持   | 结构化命令 |
| Webhook签名验证 | 支持      | 支持     | 支持  | 支持   | 不支持   |
| PGP授权决策     | 支持      | 支持     | 支持  | 支持   | 不支持   |
| Sandbox交易模拟 | 支持      | 支持     | 支持  | 支持   | 支持    |
| 自动重试        | 支持      | 支持     | 不支持 | 不支持  | 支持    |

<h2 id="versioning">
  版本策略
</h2>

五个客户端覆盖同一组协调后的公开API操作时，使用相同的`MAJOR.MINOR`版本线。每个客户端可使用独立的`PATCH`版本发布兼容性修复。

从`0.x`版本的Node.js SDK或CLI升级时，请执行明确的安装命令。固定在`0.x`的caret版本范围不会通过`npm update`升级到`1.x`。

<CardGroup cols={2}>
  <Card title="Node.js SDK" icon="node-js" href="/zh/developer-tools/sdk/nodejs/overview">
    构建带类型的Node.js和TypeScript集成。
  </Card>

  <Card title="Python SDK" icon="python" href="/zh/developer-tools/sdk/python/overview">
    构建同步Python集成。
  </Card>

  <Card title="Go SDK" icon="golang" href="/zh/developer-tools/sdk/go/overview">
    构建带类型的Go集成。
  </Card>

  <Card title="Java SDK" icon="java" href="/zh/developer-tools/sdk/java/overview">
    下载发布版JAR，并用于Java 11及以上项目。
  </Card>

  <Card title="UQPAY CLI" icon="terminal" href="/zh/developer-tools/cli/overview">
    从终端或AI Agent调用UQPAY API。
  </Card>
</CardGroup>