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
Conecte um agente de programação com IA que aceite servidores MCP remotos a https://app.tgpaycrypto.com/mcp. Ele pode ler a documentação da API, solicitar a criação de um app de comerciante, configurar webhooks e ajudar a escrever a integração. Você aprova a criação do app no bot, e o agente recebe um token restrito sem que você precise copiá-lo manualmente. Revise e teste a integração antes de aceitar pagamentos reais.
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, após o pagamento bem-sucedido, recebe o valor no saldo do seu app, descontada a taxa de comerciante.
Taxas e limites da API para comerciantes
As faturas têm uma taxa da plataforma, descontada 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
Estes são os métodos de pagamento. Uma transferência envia fundos do saldo do seu app para a carteira de um usuário do Telegram ou os mantém retidos até que um novo destinatário abra o bot. Um cheque é um link de resgate cujo valor fica reservado no seu saldo desde a criação. 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 enviam eventos ao seu servidor depois que eles acontecem. Defina a URL de webhook (opcional) 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.
Termos da API para comerciantes
Estes termos regem a API para comerciantes — apps, tokens de API, faturas, assinaturas, transferências, cheques, webhooks e o conector de agente de IA. Eles valem em conjunto com os termos gerais de uso do app e com a política de AML dele. Ao criar um app, você aceita estes termos; ao continuar usando um app criado antes de 7 de setembro de 2026, você também os aceita.