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:- 使用
clientID和apiKey获取Access Token - 缓存Token直至临近到期
- 在当前Token到期前重新获取新Token
- 提供并发安全的Token管理
幂等性
每次 API 请求都会自动带上唯一幂等键,确保安全重试、避免重复操作。你无需手动设置。错误处理
SDK 返回详细的错误信息,包含 HTTP 状态码和 API 错误详情:授权决策(PGP)
授权决策让你的端点可以实时批准或拒绝卡交易。UQPAY向你的端点发送PGP加密的交易后,SDK会解密请求、调用你的决策函数并加密响应。 实现处理器前,请阅读授权决策流程、开通要求、响应码和超时窗口。 生成RSA-2048密钥对,将公钥交给UQPAY,并妥善保管私钥:API覆盖范围
Stablecoin Account(Ramp)不在当前SDK产品范围内。
资源
使用各产品namespace。
Webhooks
验证传入的Webhook签名。
授权决策
处理PGP加密的卡授权请求。

