开发者

接入文档

asaas 提供客户侧只读接口与节点开通接口。所有请求 HTTPS，金额单位是分，时间 ISO 8601。

认证

客户中心创建 API Key 后，用 Authorization: Bearer key_id.secret 调用。secret 只显示一次，服务端存 sha256。

curl https://www.example.com/api/v1/me/subscriptions \
  -H "Authorization: Bearer ak_1234.s3cr3t" \
  -H "Accept: application/json"

客户接口

方法	路径	说明
GET	/api/v1/me/subscriptions	当前客户的租约与到期时间
GET	/api/v1/me/orders	订单列表（金额单位分）

{
  "ok": true,
  "data": [
    { "tenant_code": "t8f2k1", "plan": "专业版 · 年付",
      "ends_at": "2027-11-06T00:00:00+08:00", "seats": 50, "status": "active" }
  ]
}

节点开通接口（服务端）

asaas 调 achusaas 节点，请求头带 X-Asaas-Node / Timestamp / Nonce / Signature，签名 = HMAC-SHA256(timestamp + nonce + body, secret)。

方法	路径	说明
GET	/api/v1/health	健康检查，返回版本
POST	/api/v1/provision	按订单创建租户
POST	/api/v1/tenants/{code}/renew	续费延长
POST	/api/v1/tenants/{code}/suspend	到期停用
POST	/api/v1/tenants/{code}/resume	续费恢复

错误码

401 缺认证或 key 失效

403 无此对象权限

404 资源不存在

422 参数校验失败

429 请求过频，稍后重试

500 服务端异常，可重试

支付回调

网关回调只打 CMS 支付域，CMS 校验后服务端转发 asaas POST /api/v1/pay/callback/cms；asaas 按 out_trade_no 幂等处理，重复回调只生效一次。