无需手动处理订单
直接从您的系统创建 Stars 和 Premium 订单，并为每笔购买保存唯一标识。
Gramix 经销商解决方案
自动购买 Telegram Stars 与 Premium 的 API
将 Telegram Stars 和 Telegram Premium 接入您的网站、应用或机器人。通过程序创建订单、从经销商余额付款，并使用 API 或 webhook 跟踪交付状态。
API 文档
涵盖身份验证、余额充值、Stars 与 Premium 购买接口、订单、webhook、数据结构和代码示例。
查看文档API 价格
查看 Telegram Stars、Telegram Premium 套餐及其他 API 产品的最新经销商价格。
查看价格企业级 API
自动化销售 Telegram Stars 与 Premium
Gramix API 面向希望通过自有网站、应用、机器人或内部平台提供 Telegram Stars 和 Telegram Premium 的经销商与数字服务商。您的系统无需手动处理每笔购买，只需发送 API 请求，Gramix 即可创建可跟踪的订单。
该集成采用预付余额模式。先向专用 API 余额充值，后续订单费用即可自动扣除。这样，每笔客户订单都无需重新创建付款并等待交易确认。
订单快速进入处理
费用从可用余额中扣除，因此有效的 API 请求可以直接进入处理流程。
自动更新订单状态
通过 webhook 接收结果，也可以随时通过 API 查询订单的最新状态。
开始使用
从注册到第一笔 API 订单
基础集成只需四个清晰步骤。Gramix API v1 文档提供完整的请求参数、响应结构和可直接使用的代码示例。
- 1
创建账户和 API 密钥
注册 Gramix，在账户中打开 API 页面，并为服务器端集成生成密钥。
- 2
充值 API 余额
您可以在账户中手动充值，也可以通过 API 获取充值地址和必填 memo。
- 3
发送购买请求
提交 Telegram 用户名、所选产品以及用于防止重复订单的必填幂等键。
- 4
跟踪订单状态
保存订单 ID，通过 API 查询，或配置 webhook 自动接收状态通知。
经销商控制台
统一管理余额、付款与订单
集成可以完全通过 API 运行，同时关键操作仍可在 Gramix 账户中完成。无需开发人员参与，即可检查资金、查找订单或更新访问设置。
当前余额与手动充值
查看可用资金，并使用钱包地址和必填 memo 为 API 余额充值。付款确认后，金额会自动到账。
资金流水
查看充值、购买扣款和退款记录，每笔记录均包含日期、资金方向、金额和币种。
订单历史与状态
按 ID 查找订单，查看日期、产品、收件人、价格和当前状态，并打开完整订单详情。
集成管理
创建或轮换 API 密钥、保存安全的 HTTPS webhook URL，并快速访问文档与最新价格。
处理速度
沿用同一套交付基础设施，无需逐单付款
API 订单使用与 Gramix 网站购买相同的服务基础设施。不同之处在于，经销商资金已存入 API 余额。请求验证通过后，系统会自动扣款，订单无需等待新的付款交易即可进入处理流程。
实际交付时间取决于所选产品、收件人信息是否正确，以及相应 Telegram 服务的可用性。
- 适合持续下单的预付余额
- 使用幂等键防止重复购买
- 通过 webhook 接收 completed 和 failed 状态
- 通过唯一 ID 查询每笔订单
适用场景
面向经销商、商店和 Telegram 服务商的 API
在线商店
将 Telegram Stars 和 Premium 加入商品目录，并将客户已付款订单自动发送至 Gramix。
Telegram 机器人与应用
构建自有购买界面，并通过 REST API 连接服务器端订单处理。
高频订单经销商
使用统一余额、自动完成重复操作，并跟踪每位客户的订单结果。
常见问题
关于 Gramix API 的问题
Gramix API 适合哪些用户？
Gramix API 适合需要为客户自动购买 Telegram Stars 和 Telegram Premium 的经销商、在线商店、Telegram 机器人、代理机构及其他数字服务商。
可以通过 API 订购哪些 Telegram 产品？
Gramix API 支持创建 Telegram Stars 和 Telegram Premium 订阅订单。API 价格页面会列出当前可用产品、订阅周期和经销商价格。
如何为 API 订单充值余额？
您可以在 Gramix 账户中复制钱包地址和必填 memo，然后手动发送付款；系统也可以通过 API 获取充值信息。交易确认后，余额会自动更新。
在哪里跟踪订单和付款？
Gramix 账户会显示当前余额、充值、扣款、退款以及包含收件人、金额和状态的订单列表。您也可以通过 API 查询订单状态，或使用 webhook 接收更新。
为什么 API 订单不需要单独付款？
订单费用从预先充值的 API 余额中扣除。每笔购买都无需重新创建和确认付款交易，因此有效请求可以立即进入处理流程。
准备接入 Telegram Stars 与 Premium API？
比较最新经销商价格、查看请求格式，并创建账户以生成 API 密钥和开始集成。