概览
通过 Glacix API 为你的持卡人签发并管理虚拟卡与实体卡。
环境
| 环境 | Base URL | 用途 |
|---|---|---|
| 沙箱 | https://api.sandbox.glacix.io | 开发、联调和完整流程验证 |
| 生产 | https://api.glacix.io | 正式业务请求 |
除文件上传使用 multipart/form-data 外，请求与响应均使用 JSON。所有请求都必须携带唯一的 X-Request-Id；获取令牌之外的业务接口还必须携带 Bearer Token。
API 能力
| 分组 | 主要能力 |
|---|---|
| 认证授权 | 使用 API Key 和 Secret 获取访问令牌 |
| 账户 | 查询账户发卡余额 |
| 持卡人管理 | 创建、更新、查询持卡人及获取 KYC 链接 |
| 支付卡管理 | 产品、开卡、卡状态、充值、提现和交易查询 |
| 文件 | 上传和下载业务文件 |
| Webhooks | 卡片、交易、持卡人相关事件 |
推荐接入顺序
- 在沙箱环境使用 API Key 和 Secret 获取访问令牌。
- 为每次请求生成
X-Request-Id，并在服务端日志中保留请求与响应结果。 - 根据业务选择发卡或汇款流程完成端到端联调。
- 接入相关 Webhook，以异步事件确认资源的最终状态。
- 完成敏感数据保护、幂等、超时查询、对账和告警后再切换生产环境。