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.
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.
Related pages
¿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.
