接入准备

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

基础信息

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

前置条件

在开始之前，请确保您已经：

  • 注册了 StablePay 商户账号
  • 获取了 API 密钥 和 Secret Key
  • 具备基本的 HTTP API 调用知识

获取 API 密钥

  1. 登录 StablePay 商户后台
  2. 进入 店铺管理 ，点击[创建店铺]，渠道类型 选择 API，提交后等待StablePay审核
  3. 审核通过后，您可以通过店铺列表操作[管理密钥]，获得密钥

安全提示

请妥善保管您的 API 密钥，不要将其提交到公开代码仓库或泄露给他人。

收银台展示建议

收银台展示建议 - 优化收银台中稳定币支付的展示方式，提升支付转化率

主要内容：

  • 推荐展示方式（USDT | USDC Stablecoin Payment）
  • API 对接最佳实践（PC 电商 / 移动端 / 游戏）
  • Shopify / WooCommerce / Shoplazza / SHOPYY 集成展示建议
  • StablePay Logo 及稳定币/钱包 Logo 素材下载

支付服务

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

核心功能：

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

适用场景：

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

订阅服务

Subscription API - 创建和管理自动续费订阅，覆盖订阅、账单、订阅支付查询和订阅退款。

核心功能：

  • 创建订阅并返回 checkout_url
  • 查询/列表/取消订阅
  • 查询账单与订阅支付会话
  • 查询支付方式（Payment Method）
  • 对订阅支付发起退款

适用场景：

  • SaaS 自动续费
  • 会员订阅
  • 周期性数字服务收费

退款服务

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

核心功能：

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

退款特性：

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