---
title: "Buy Stars 
购买电报Stars"
method: POST
path: "/v1/stars"
tags: ["API SERVICE"]
---

# Buy Stars 
购买电报Stars

`POST /v1/stars`

## Query parameters

- `username` string, required
- `quantity` integer, required
- `client_order_id` string

## Headers

- `CF-ACCESS-KEY` string, required
- `CF-ACCESS-SIGN` string, required
- `CF-ACCESS-TIMESTAMP` string, required

## Response `200`

OK

- XPremiumOrderPayload
  - `code` integer — 成功返回0，其他均为错误
  - `msg` string — 发生错误时候返回的消息
  - `sub_code` string
  - `sub_msg` string
  - `data` PremiumOrderPayload — Fragment商品订单详情
    - `member_id` integer — 会员ID
    - `order_id` string — 订单ID
    - `client_order_id` string — 客户自定义订单ID
    - `username` string — 要购买的电报用户username
    - `product_type` 'PREMIUM' | 'STARS' — Fragment商品类型
    - `quantity` integer — Stars数量
    - `months` integer — 会员时长(月)
    - `usdt_sun` integer — 付款金额U
    - `cost_usdt_sun` integer — 成本金额U
    - `source_type` 'TRANSFER' | 'DAPP' | 'BALANCE' | 'API' | 'BOT' — 来源类型
    - `created_at` integer — 创建时间
    - `status` 'UNPAID' | 'PAID' | 'CREATED' | 'FINISHED' | 'PAY_FAILED' | 'BUY_FAILED' | 'CREATED_FAILED' — 状态

---

[API](https://skmtc.net/catfee/apis/fragment-api.md) · [All operations](https://skmtc.net/catfee/apis/fragment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/catfee/fragment-api/revisions/319931af7b67/schema)