查询订阅

GET/api/v1/bank/wallet/subscription/Bearer Token

身份验证

需要 Bearer 令牌。参见身份验证。

请求参数

查询参数：

字段	类型	必填	说明
wallet_uuid	string (UUID)	是	拥有该订阅的钱包
subscription_uuid	string (UUID)	是	要查询的订阅

示例 URL

GET /api/v1/bank/wallet/subscription/?wallet_uuid=890023ec-aeaf-4be2-9d86-a244ba0f4ac&subscription_uuid=96b95c56-34f0-48c0-93e9-ac5fc6d3f3d5

响应示例

200 Success

{
  "subscription_uuid": "96b95c56-34f0-48c0-93e9-ac5fc6d3f3d5",
  "cycle": "monthly",
  "end_date": "2027-06-30",
  "status": "active",
  "description": "高级套餐",
  "next_due_date": "2026-04-30",
  "charges": [
    {
      "charge_uuid": "c950b2e5-95f8-40c2-b58e-e3c66c6cc100",
      "value": 99.90,
      "currency": "BRL",
      "date": "2026-03-30",
      "status": "confirmed"
    }
  ]
}

404 Not Found

{
  "code": "errors.subscription.not_found"
}

404 Wallet Not Found

{
  "code": "errors.wallet.not_found"
}

订阅状态

状态	说明	可转换为
pending	初始扣款尚未确认	active、error
active	运行中——按周期生成扣款	error、cancelled、expired
error	上次扣款尝试失败	active（重试）、cancelled、expired
cancelled	手动停止	终态
expired	已到结束日期或重试次数耗尽	终态

代码示例

cURL

curl -sS 'https://core-manager.a55.tech/api/v1/bank/wallet/subscription/?wallet_uuid=890023ec-aeaf-4be2-9d86-a244ba0f4ac&subscription_uuid=96b95c56-34f0-48c0-93e9-ac5fc6d3f3d5' \
  -H 'Authorization: Bearer $ACCESS_TOKEN'

Python

import os, requests

r = requests.get(
    "https://core-manager.a55.tech/api/v1/bank/wallet/subscription/",
    headers={"Authorization": f"Bearer {os.environ['ACCESS_TOKEN']}"},
    params={
        "wallet_uuid": "890023ec-aeaf-4be2-9d86-a244ba0f4ac",
        "subscription_uuid": "96b95c56-34f0-48c0-93e9-ac5fc6d3f3d5",
    },
    timeout=30,
)
sub = r.json()
print(f"状态：{sub['status']}，下次计费：{sub['next_due_date']}")

JavaScript

const params = new URLSearchParams({
  wallet_uuid: '890023ec-aeaf-4be2-9d86-a244ba0f4ac',
  subscription_uuid: '96b95c56-34f0-48c0-93e9-ac5fc6d3f3d5',
});
const res = await fetch(
  `https://core-manager.a55.tech/api/v1/bank/wallet/subscription/?${params}`,
  { headers: { Authorization: `Bearer ${process.env.ACCESS_TOKEN}` } }
);
const sub = await res.json();