API 参考

StablePay API 是一套基于 REST 架构的 API 集合，用于管理加密货币支付和退款。我们的 API 遵循 REST 设计原则，使用标准的 HTTP 方法和状态码，返回 JSON 格式的响应。

快速开始

如果你是第一次使用 StablePay API，建议先阅读快速开始指南了解基本概念。

基础信息

  • 生产环境: https://api.stablepay.co/api/v1
  • 测试环境: https://api-test.stablepay.co/api/v1
  • 协议: HTTPS
  • 数据格式: JSON
  • 字符编码: UTF-8

核心概念

在开始使用 API 之前，了解这些核心概念将帮助你更好地集成。

认证

使用 API 密钥对请求进行身份验证。了解如何安全地获取、管理和轮换 API 密钥。

要点：

  • Bearer Token 认证
  • API 密钥管理
  • 安全最佳实践

请求和响应

了解如何构建 API 请求和解析响应，包括标准响应格式和数据结构。

要点：

  • 请求格式和 Headers
  • 响应结构和状态码
  • 数据类型和格式

错误处理

完整的错误代码、类型和处理策略。了解错误响应以及如何调试问题。

要点：

  • 标准错误格式
  • 常见错误代码
  • 错误处理最佳实践

API 功能特性

分页

使用分页参数高效检索大型数据集，支持基于页码和游标的分页方式。

频率限制

了解请求配额和频率限制规则（默认：100 请求/分钟），确保 API 稳定性和公平使用。

API 版本控制

了解 API 版本管理和向后兼容性策略（当前版本：v1）。

API 服务

支付服务

Payment API - 创建和管理支付会话，支持多种加密货币和稳定币

核心功能：

  • 创建支付会话（Checkout Session）
  • 查询支付状态和详情
  • 取消支付会话
  • 自动汇率转换和锁定
  • 支持多币种（USDT、USDC等）

适用场景：

  • 电商在线支付
  • SaaS 服务订阅
  • 数字商品销售
  • 跨境支付结算

退款服务

Refund API - 处理退款请求，支持全额和部分退款

核心功能：

  • 创建退款请求
  • 查询退款状态和详情
  • 取消待处理的退款
  • 退款原因记录

退款特性：

  • 支持部分退款
  • 同一订单可多次退款
  • 异步退款处理
  • 区块链交易追踪
最后更新 / Last Updated: