★ Para desarrolladores

Telegram Stars API

Vende Telegram Stars y Premium dentro de tu propio bot, tienda o aplicación. Una API HTTPS, un saldo compartido con el bot StarKerak y el sitio web.

Entrega automáticala mayoría de los pedidos en minutos
Comprobación del nombre de usuarioantes de pagar
Precios abiertosiguales en el sitio y en la API
Registro públicocada pedido recibe un TxId

Qué hace la API

  • POST /api/v1/check-username — verifica un destinatario y obtén un token de verificación de corta duración
  • POST /api/v1/stars/buy y /api/v1/premium/buy — crea pedidos (Idempotency-Key obligatorio)
  • GET /api/v1/order/{id} y /api/v1/orders — estados e historial
  • GET /api/v1/prices, /api/v1/account, monedero en USD y facturas en USDT

La autenticación usa una cabecera X-API-Key. Las claves se crean en el panel y no caducan hasta que las revoques.

Hecho para producción

Cada pedido lleva tu Idempotency-Key, así que los reintentos nunca cobran dos veces. La comprobación del destinatario evita pagos a nombres de usuario inexistentes. El límite es de 10 solicitudes por segundo por clave.

Todos los pedidos se pagan desde el saldo en USD (currency=USD; UZS se trata como USD). Pasa max_usd para limitar el precio que aceptas.

Transparencia

Cada pedido completado recibe un TxId registrado en el libro público de PayStars, para que tú y tus clientes puedan verificar la entrega de forma independiente.

Precio de Fragment, 0 % (sitio web: 5 %)

Los pedidos con clave de API desde el saldo en USD se tarifican al precio en vivo de Fragment 0 % (sitio web: 5 %); los pedidos del sitio y de la miniaplicación muestran el importe exacto antes de pagar. Obtén el precio con POST /usd/quote y limítalo con max_usd. Detalles en la página de la API de Fragment.

Preguntas frecuentes

¿Hay un entorno de pruebas?

Usa pedidos reales pequeños (50 Stars) mientras integras; la clave de idempotencia hace que los reintentos sean seguros.

¿Qué lenguajes son compatibles?

Cualquier lenguaje con HTTPS. Consulta las guías rápidas de Python, Node.js y PHP.

¿Las claves de API caducan?

No. Las claves siguen siendo válidas hasta que las revoques en el panel.

¿Puedo pagar en USD?

Sí: recarga el saldo en USD con USDT (TON, BEP20 o TRC20) y envía currency=USD.

¿Listo para pedir?

Inicia sesión con Telegram: tu saldo de StarKerak funciona en el sitio, en la WebApp y a través de la API.