开发者文档

支付集成从这里开始

完整的 API 文档、代码示例与对接指南,助您最快 1 天完成支付接入。

快速开始 API 参考 SDK 下载 沙盒环境 状态监控

欢迎使用得锆开放平台

得锆开放平台为开发者提供统一的支付 API,通过一次接入即可覆盖聚合收款、智能风控等全链路支付能力。

我们提供 RESTful API 与多语言 SDK,并配有完善的沙盒测试环境,帮助您快速完成开发联调,上线后享受稳定的 99.99% 服务可用性。

提示:建议先在沙盒环境完成开发调试,确认业务逻辑正确后再切换至生产环境。

5 分钟快速接入

按照以下步骤在沙盒环境中完成您的第一笔支付:

1

获取 API 密钥

登录开发者控制台,在「密钥管理」中创建应用,获取 api_keyapi_secret

2

安装 SDK

选择您的开发语言安装对应 SDK,或直接使用 HTTP 调用 API。

3

创建订单

调用下单接口,获取支付 URL 或二维码,引导用户完成支付。

4

处理回调

配置 Webhook 回调地址,接收支付结果通知并更新业务状态。

Python · 创建支付订单
# 安装: pip install degao-sdk
import degao
 
client = degao.Client(
  api_key="sandbox_key_xxxxxxxx",
  api_secret="sandbox_secret_xxxxxxxx",
  sandbox=True # 沙盒模式
)
 
order = client.orders.create({
  "amount": 9900, # 单位: 分
  "currency": "CNY",
  "subject": "测试订单 #1001",
  "channel": "alipay",
  "notify_url": "https://yoursite.com/webhook",
  "return_url": "https://yoursite.com/success"
})
 
print(order.pay_url) # 跳转至支付宝收银台

鉴权方式

得锆 API 使用 HMAC-SHA256 签名机制进行请求鉴权,所有请求需在 Header 中携带 Authorization 字段。

HTTP Headers
Authorization: DEGAO-HMAC-SHA256
  Credential=your_api_key/20240312/cn-beijing/degao,
  SignedHeaders=content-type;host;x-degao-date,
  Signature=abc123def456...
 
X-Degao-Date: 20240312T120000Z
Content-Type: application/json
安全提示:请妥善保管 api_secret,切勿将密钥提交至代码仓库或暴露在前端代码中。建议通过环境变量管理密钥。

环境地址

沙盒环境
https://sandbox-api.degaoco.com
仅供开发测试,不产生真实资金流动
生产环境
https://api.degaoco.com
需通过资质审核后方可使用