Skip to main content
本指南介绍如何开始使用 Cobo Payments Go SDK,它允许您使用 Go 编程语言将 Cobo 支付服务集成到您的现有 App 中。 要了解使用 Payments API 所需的初始设置步骤,请参阅发送您的第一个 API 请求 您可以访问 GitHub 查看 SDK 的源代码。

前提条件

  • 您已安装 Go 1.18 或更新版本。
  • 按照开发环境前置准备中的说明设置您的 Cobo 账户并创建您的团队。如果已经设置了团队,请让您的团队管理员邀请您加入团队。
  • 按照发送您的第一个 API 请求中的说明,生成 API Key 和 API Secret,并在 Cobo Portal 上注册了 API Key。

安装 SDK

  1. 如果您还没有,请创建一个 Go 项目。
  2. 在您项目的 go.mod 文件中,添加以下行:
    require github.com/CoboGlobal/cobo-waas2-go-sdk {VERSION}
    
    将 {VERSION} 替换为最新版本号,例如 v1.2.0。从 GitHub 仓库获取最新版本号。
  3. 在终端或您的 IDE 中运行 go mod tidy 命令以安装依赖项。
  4. 在您的 main.go 文件中,按如下方式导入 WaaS SDK:
    import (
        ...
        coboWaas2 "github.com/CoboGlobal/cobo-waas2-go-sdk/cobo_waas2"
        ...
    )
    

配置 API Key 和 HTTP Host

在您的 main.go 文件的主函数中,通过选择环境来配置 HTTP Host并提供您的 API Secret。 以下代码片段显示了开发环境的配置。
// 选择您使用的环境并注释掉另一行代码
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 文件夹。