API para comerciantes (Desenvolvedores)
A API para comerciantes: apps, faturas, transferências e webhooks.
O que é a API para comerciantes?
A API para comerciantes é a API de pagamentos do app para empresas e bots. Você cria um app, recebe um token de API e usa esse token para cobrar usuários do Telegram, mandar pagamentos para eles e consultar seu saldo — tudo do seu próprio código.
Primeiros passos para desenvolvedores
Crie um app no Mini App, copie o token de API uma vez e comece a chamar a API. Toda a configuração fica em Mais → API para comerciantes.
Conectar um agente de IA
Passe uma única URL para o seu agente de IA de programação — https://app.tgpaycrypto.com/mcp — e ele monta a integração de pagamentos para você: lê a documentação da API, cria o seu app de comerciante, configura os webhooks e escreve o código. Você aprova o app novo uma vez, com um botão só, no bot. Sem terminal e sem token de API para copiar na mão.
Aceitando pagamentos com faturas
Uma fatura é como você cobra um usuário do Telegram. Você cria uma pela API, manda o link para quem vai pagar, e o saldo do seu app é creditado no instante em que a pessoa confirma.
Taxas e limites da API para comerciantes
As faturas têm uma taxa da plataforma, tirada do que você recebe; as transferências e os cheques são limitados por valor. Os números abaixo são as configurações atuais, não termos de contrato — quando eles divergirem do que você vê, quem está certo é o app, e a fonte confiável são sempre as suas próprias faturas pagas.
Referência da API para comerciantes
As convenções que todos os métodos compartilham, mais os métodos de catálogo somente leitura. Páginas método a método: faturas e reembolsos, transferências e cheques, assinaturas, webhooks.
Referência da API: faturas e reembolsos
Os métodos de fatura: createInvoice, getInvoices, deleteInvoice, refundInvoice. As convenções (autenticação, envelope, valores, spend_id) estão na página da referência da API para comerciantes; o passo a passo guiado está em aceitando pagamentos com faturas.
Referência da API: transferências e cheques
Os métodos de pagamento. Uma transferência manda fundos do saldo do seu app direto para a carteira de um usuário do Telegram; um cheque é um link resgatável que você banca antes. As convenções (autenticação, envelope, valores, spend_id) estão na página da referência da API para comerciantes.
Referência da API: assinaturas
Cobrança recorrente — uma extensão sobre o Crypto Bot. Você cria um plano (valor + período), manda aos usuários o link de aprovação dele, e a plataforma cobra dessas pessoas, com o saldo da carteira delas, a cada período, creditando o saldo do seu app já líquido de taxa. As convenções estão na página da referência da API para comerciantes.
Referência da API: webhooks
Os webhooks empurram eventos para o seu servidor no momento em que eles acontecem. Defina a URL de webhook do seu app em Mais → API para comerciantes; a plataforma então faz POST de um corpo JSON assinado para cada evento que você assinou.