Pedidos sem processamento manual
Crie pedidos de Stars e Premium diretamente no seu sistema e guarde um identificador único para cada compra.
Gramix para revendedores
API para automatizar compras de Telegram Stars e Premium
Integre Telegram Stars e Telegram Premium ao seu site, aplicativo ou bot. Crie pedidos de forma programática, pague com o saldo de revendedor e acompanhe a entrega pela API ou por webhook.
Documentação da API
Autenticação, recarga de saldo, métodos de compra de Stars e Premium, pedidos, webhooks, schemas e exemplos de código.
Ler documentaçãoPreços da API
Preços atuais para revendedores de Telegram Stars, planos Telegram Premium e outros produtos disponíveis pela API.
Ver preçosAPI para empresas
Automatize suas vendas de Telegram Stars e Premium
A API Gramix foi criada para revendedores e serviços digitais que desejam oferecer Telegram Stars e Telegram Premium em seu próprio site, aplicativo, bot ou plataforma interna. Em vez de processar cada compra manualmente, seu sistema envia uma solicitação à API e a Gramix cria um pedido que pode ser acompanhado.
A integração usa um saldo pré-pago. Adicione fundos ao saldo exclusivo da API e permita que os novos pedidos sejam debitados automaticamente. Assim, não é necessário criar e aguardar a confirmação de um pagamento separado antes de cada compra dos seus clientes.
Início rápido do pedido
O pagamento é debitado do saldo disponível, então uma solicitação válida pode seguir diretamente para o processamento.
Atualizações automáticas de status
Receba o resultado por webhook ou consulte na API o status mais recente do pedido quando precisar.
Como começar
Do cadastro ao primeiro pedido pela API
Uma integração básica tem quatro etapas simples. A documentação da Gramix API v1 inclui todos os parâmetros, schemas de resposta e exemplos de código prontos para uso.
- 1
Crie uma conta e uma chave API
Cadastre-se na Gramix, abra a seção API da sua conta e gere uma chave para a integração entre servidores.
- 2
Adicione saldo para a API
Envie fundos manualmente pela sua conta ou solicite o endereço de depósito e o memo de forma programática pela API.
- 3
Envie uma solicitação de compra
Informe o username do Telegram, o produto selecionado e uma chave de idempotência obrigatória para evitar pedidos duplicados.
- 4
Acompanhe o status do pedido
Guarde o ID do pedido, consulte-o pela API ou configure um webhook para receber atualizações automaticamente.
Painel do revendedor
Saldo, pagamentos e pedidos em um só lugar
Você pode operar toda a integração pela API e continuar acessando os controles essenciais na sua conta Gramix. Consulte os fundos, encontre pedidos ou altere as configurações de acesso sem depender de um desenvolvedor.
Saldo atual e recarga manual
Consulte os fundos disponíveis e recarregue o saldo da API usando o endereço da carteira e o memo obrigatório. O valor é creditado automaticamente após a confirmação do pagamento.
Histórico de transações
Consulte depósitos, débitos de compras e reembolsos com a data, direção, valor e moeda de cada movimentação.
Histórico e status dos pedidos
Localize pedidos pelo ID, veja data, produto, destinatário, preço e status atual e abra os detalhes completos de cada pedido.
Gerenciamento da integração
Crie ou renove sua chave API, salve uma URL HTTPS segura para o webhook e acesse a documentação ou os preços atuais.
Velocidade de processamento
A mesma infraestrutura de entrega, sem pagar cada pedido separadamente
Os pedidos da API usam a mesma infraestrutura de serviços Gramix das compras feitas no site. Para o revendedor, a diferença é que os fundos já estão disponíveis no saldo da API. Após a validação da solicitação, o valor é debitado automaticamente e o pedido entra em processamento sem aguardar outra transação de pagamento.
O prazo real de entrega depende do produto escolhido, da validade dos dados do destinatário e da disponibilidade do serviço correspondente do Telegram.
- Saldo pré-pago para pedidos recorrentes
- Chaves de idempotência para impedir compras duplicadas
- Status completed e failed por webhooks
- Consulta de cada pedido pelo seu ID único
Para quem é
Uma API para revendedores, lojas e serviços do Telegram
Lojas online
Adicione Telegram Stars e Premium ao seu catálogo e envie automaticamente à Gramix os pedidos já pagos pelos clientes.
Bots e aplicativos do Telegram
Crie sua própria experiência de compra e conecte o processamento de pedidos no servidor por uma API REST.
Revendedores com pedidos frequentes
Trabalhe com um saldo unificado, automatize tarefas repetitivas e acompanhe o resultado de cada pedido de cliente.
Perguntas frequentes
Dúvidas sobre a API Gramix
Para quem a API Gramix foi criada?
A API Gramix foi criada para revendedores, lojas online, bots do Telegram, agências e outros serviços que precisam automatizar compras de Telegram Stars e Telegram Premium para seus clientes.
Quais produtos do Telegram posso pedir pela API?
A API Gramix permite criar pedidos de Telegram Stars e assinaturas Telegram Premium. A página de preços da API mostra os produtos, períodos de assinatura e valores para revendedores disponíveis no momento.
Como adiciono saldo para os pedidos da API?
Você pode recarregar manualmente pela conta Gramix: copie o endereço da carteira e o memo obrigatório antes de enviar o pagamento. Seu sistema também pode solicitar os dados de depósito pela API. O saldo é atualizado automaticamente após a confirmação da transação.
Onde acompanho pedidos e pagamentos?
Sua conta Gramix mostra o saldo atual, depósitos, débitos, reembolsos e uma lista de pedidos com destinatários, valores e status. Também é possível consultar o status pela API ou recebê-lo por webhook.
Por que um pedido pela API não exige um pagamento separado?
O valor é debitado do saldo pré-pago da API. Não é necessário criar e confirmar uma nova transação para cada compra, por isso uma solicitação válida pode entrar diretamente em processamento.
Pronto para integrar a API de Telegram Stars e Premium?
Compare os preços atuais para revendedores, consulte o formato das solicitações e crie uma conta para gerar sua chave API e iniciar a integração.