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

# JavaScript SDK 快速入门

本指南介绍如何开始使用 Cobo Payments JavaScript SDK，它允许您使用 JavaScript 编程语言将 Cobo 支付服务集成到您的现有 App 中。

要了解使用 Payments API 所需的初始设置步骤，请参阅[发送您的第一个 API 请求](/payments/cn/developer-tools/get-started-with-api)。

您可以访问 [GitHub](https://github.com/CoboGlobal/cobo-waas2-js-sdk/) 查看 SDK 的源代码。

## 前提条件

* 安装 Node.js 和 NPM。
* 按照[开发环境前置准备](/payments/cn/guides/preparation)中的说明设置您的 Cobo 账户并创建您的团队。如果已经设置了团队，请让您的团队管理员邀请您加入团队。
* 按照[发送您的第一个 API 请求](/payments/cn/developer-tools/get-started-with-api)中的说明，生成 API Key 和 API Secret，并在 Cobo Portal 上注册了 API Key。

## 安装与项目准备

1. 创建项目根目录并初始化 NPM：

```bash theme={null}
mkdir waas2-js && cd waas2-js
npm init -y
```

2. 安装 SDK：

```bash theme={null}
npm install @cobo/cobo-waas2 --save
```

安装完成后的目录结构（示例）如下：

```text theme={null}
waas2-js/
├─ node_modules/
├─ package.json
├─ package-lock.json
└─ (稍后将创建) index.js
```

<Tip>如果您的项目已存在 <code>package.json</code> 和 <code>package-lock.json</code>，可直接将二者放到根目录后执行 <code>npm install</code> 拉取依赖。</Tip>

3. 在项目根目录创建一个文件 <code>index.js</code>，并将以下示例代码粘贴到该文件中。

## 配置 API Key 和 HTTP Host

1. 设置 API Secret。

```javascript theme={null}
// 初始化默认 API 客户端
const apiClient = CoboWaas2.ApiClient.instance
// 设置 API Secret
apiClient.setPrivateKey("<YOUR_API_SECRET_IN_HEX>");
```

2. 选择环境。

```javascript theme={null}
// 选择开发环境
apiClient.setEnv(CoboWaas2.Env.DEV);

// 选择生产环境
// apiClient.setEnv(CoboWaas2.Env.PROD);
```

## 示例代码

API 操作级别的文档和示例代码请参照 Payments API SDK GitHub 仓库内的 [docs](https://github.com/CoboGlobal/cobo-waas2-js-sdk/tree/master/docs) 文件夹。