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

# Go SDK 快速入门

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

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

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

## 前提条件

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

## 安装 SDK

1. 如果您还没有，请创建一个 Go 项目。

2. 在您项目的 `go.mod` 文件中，添加以下行：

   ```go theme={null}
   require github.com/CoboGlobal/cobo-waas2-go-sdk {VERSION}
   ```

   <Note>将 \{VERSION} 替换为最新版本号，例如 `v1.2.0`。从 [GitHub 仓库](https://github.com/CoboGlobal/cobo-waas2-go-sdk/tags)获取最新版本号。</Note>

3. 在终端或您的 IDE 中运行 `go mod tidy` 命令以安装依赖项。

4. 在您的 `main.go` 文件中，按如下方式导入 WaaS SDK：

   ```go theme={null}
   import (
       ...
       coboWaas2 "github.com/CoboGlobal/cobo-waas2-go-sdk/cobo_waas2"
       ...
   )
   ```

## 配置 API Key 和 HTTP Host

在您的 `main.go` 文件的主函数中，通过选择环境来配置 HTTP Host并提供您的 API Secret。
以下代码片段显示了开发环境的配置。

```go theme={null}
// 选择您使用的环境并注释掉另一行代码
ctx = context.WithValue(ctx, coboWaas2.ContextEnv, coboWaas2.DevEnv)
// ctx = context.WithValue(ctx, coboWaas2.ContextEnv, coboWaas2.ProdEnv)
ctx = context.WithValue(ctx, coboWaas2.ContextPortalSigner, crypto.Ed25519Signer{
    // 将 `<YOUR_API_SECRET>` 替换为您的 API Secret。
    Secret: "<YOUR_API_SECRET>",
})
```

## 示例代码

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