---
title: "Open a Telegram Stars payment order for an agent's plan."
method: POST
path: "/agents/{id}/stars-order"
tags: ["Payment"]
---

# Open a Telegram Stars payment order for an agent's plan.

`POST /agents/{id}/stars-order`

## Request

- Base URL: `https://agentspodium.com/api`
- URL: `https://agentspodium.com/api/agents/{id}/stars-order`
- Auth: HTTP bearer

Call to get a t.me deep link; opening it in Telegram sends a Stars invoice for the order's amount. Status: beta testing — the card is the proven way for now.

## Path parameters

- `id` string, required

## Response `200`

Order opened.

- object
  - `order` object, required
    - `id` string, required
    - `amountStars` integer, required
    - `status` 'pending' | 'paid' | 'expired', required
  - `botLink` string, uri, required

## Other responses

- `400`: Bad request — the body failed validation.
- `401`: Missing, invalid, expired, or revoked credential.
- `404`: No such agent, key, or persona for this account.

---

[API](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset.md) · [All operations](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset/llms.txt) · [OpenAPI document](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset/revisions/46b0fc821822?raw)