本指南介绍如何开始使用 Cobo Payments JavaScript SDK,它允许您使用 JavaScript 编程语言将 Cobo 支付服务集成到您的现有 App 中。
要了解使用 Payments API 所需的初始设置步骤,请参阅发送您的第一个 API 请求。
您可以访问 GitHub 查看 SDK 的源代码。
前提条件
- 安装 Node.js 和 NPM。
- 按照开发环境前置准备中的说明设置您的 Cobo 账户并创建您的团队。如果已经设置了团队,请让您的团队管理员邀请您加入团队。
- 按照发送您的第一个 API 请求中的说明,生成 API Key 和 API Secret,并在 Cobo Portal 上注册了 API Key。
安装与项目准备
- 创建项目根目录并初始化 NPM:
mkdir waas2-js && cd waas2-js
npm init -y
- 安装 SDK:
npm install @cobo/cobo-waas2 --save
安装完成后的目录结构(示例)如下:
waas2-js/
├─ node_modules/
├─ package.json
├─ package-lock.json
└─ (稍后将创建) index.js
如果您的项目已存在 package.json 和 package-lock.json,可直接将二者放到根目录后执行 npm install 拉取依赖。
- 在项目根目录创建一个文件
index.js,并将以下示例代码粘贴到该文件中。
配置 API Key 和 HTTP Host
- 设置 API Secret。
// 初始化默认 API 客户端
const apiClient = CoboWaas2.ApiClient.instance
// 设置 API Secret
apiClient.setPrivateKey("<YOUR_API_SECRET_IN_HEX>");
- 选择环境。
// 选择开发环境
apiClient.setEnv(CoboWaas2.Env.DEV);
// 选择生产环境
// apiClient.setEnv(CoboWaas2.Env.PROD);
示例代码
API 操作级别的文档和示例代码请参照 Payments API SDK GitHub 仓库内的 docs 文件夹。