Skip to main content
UQPAY Go SDK以带类型的方式访问Account Center、Global Account、Global Acquiring、Card Issuance和Supporting Services。它内置自动Access Token管理、自动幂等键、请求选项、Webhook签名验证、PGP授权决策和Sandbox交易模拟。

GitHub

github.com/uqpay/uqpay-sdk-go/v2
SDK需要Go 1.19或更高版本。v2.1.0是当前稳定版本。v1.2.0是它首次加入协调客户端版本线的发布版本。

安装

快速上手

开始前,请先创建沙盒账户创建API密钥

配置

Sandbox:
Production:

鉴权

SDK自动管理UQPAY Access Token:
  • 使用clientIDapiKey获取Access Token
  • 缓存Token直至临近到期
  • 在当前Token到期前重新获取新Token
  • 提供并发安全的Token管理

幂等性

每次 API 请求都会自动带上唯一幂等键,确保安全重试、避免重复操作。你无需手动设置。

错误处理

SDK 返回详细的错误信息,包含 HTTP 状态码和 API 错误详情:
错误格式示例:

授权决策(PGP)

授权决策让你的端点可以实时批准或拒绝卡交易。UQPAY向你的端点发送PGP加密的交易后,SDK会解密请求、调用你的决策函数并加密响应。 实现处理器前,请阅读授权决策流程、开通要求、响应码和超时窗口 生成RSA-2048密钥对,将公钥交给UQPAY,并妥善保管私钥:
配置密钥并注册HTTP handler:
SDK会将金额保留为字符串,同时兼容JSON string和number形式的金额。处理失败时,HTTP handler会中止响应,让UQPAY执行已配置的超时动作。

API覆盖范围

Stablecoin Account(Ramp)不在当前SDK产品范围内。

资源

使用各产品namespace。

Webhooks

验证传入的Webhook签名。

授权决策

处理PGP加密的卡授权请求。