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

> Choose an official UQPAY SDK or the UQPAY CLI for your integration.

UQPAY provides official SDKs for Node.js, Python, Go, and Java. The UQPAY CLI exposes the same public API operations for command-line and AI agent workflows.

Version `1.2.0` is the first coordinated release across all five clients: each client covers the same set of public API operations. Later compatible fixes may increment each client's patch version independently, so check its package registry or release page for the latest version.

## Choose a client

| Client  | Runtime                           | Package or release                                                          | Install                                          |
| ------- | --------------------------------- | --------------------------------------------------------------------------- | ------------------------------------------------ |
| 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)         | Download the release JAR                         |
| CLI     | Node.js 22+ for the npm installer | [`@uqpay/cli`](https://www.npmjs.com/package/@uqpay/cli)                    | `npm install -g @uqpay/cli`                      |

<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.
</Warning>

## API coverage

The clients provide typed or structured access to the public callable operations in:

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

<Note>
  Stablecoin Account (Ramp) is not included in the current SDK or CLI product scope. Use the [Stablecoin Account integration guides](/stablecoin-account/v1.6/guide/overview) directly.
</Note>

## Common capabilities

All four language SDKs automatically retrieve and cache a UQPAY Access Token, then retrieve a new Token before the current one expires. They also support per-request options for idempotency and sub-account operations.

Additional capabilities vary by client:

| Capability                     | Node.js | Python | Go  | Java | CLI                 |
| ------------------------------ | ------- | ------ | --- | ---- | ------------------- |
| Typed API resources            | Yes     | Yes    | Yes | Yes  | Structured commands |
| Webhook verification           | Yes     | Yes    | Yes | Yes  | No                  |
| PGP authorization decisions    | Yes     | Yes    | Yes | Yes  | No                  |
| Sandbox transaction simulation | Yes     | Yes    | Yes | Yes  | Yes                 |
| Automatic retries              | Yes     | Yes    | No  | No   | Yes                 |

## Versioning

The five client tools use the same `MAJOR.MINOR` release line when they cover the same coordinated set of public API operations. Each client may release compatible fixes under its own `PATCH` version.

When upgrading from a `0.x` Node.js SDK or CLI version, use an explicit install command. A caret range pinned to `0.x` does not move to `1.x` through `npm update`.

<CardGroup cols={2}>
  <Card title="Node.js SDK" icon="node-js" href="/developer-tools/sdk/nodejs/overview">
    Build typed Node.js and TypeScript integrations.
  </Card>

  <Card title="Python SDK" icon="python" href="/developer-tools/sdk/python/overview">
    Build synchronous Python integrations.
  </Card>

  <Card title="Go SDK" icon="golang" href="/developer-tools/sdk/go/overview">
    Build typed Go integrations.
  </Card>

  <Card title="Java SDK" icon="java" href="/developer-tools/sdk/java/overview">
    Build Java 11+ integrations from the release JAR.
  </Card>

  <Card title="UQPAY CLI" icon="terminal" href="/developer-tools/cli/overview">
    Call UQPAY APIs from a terminal or AI agent.
  </Card>
</CardGroup>