API para comerciantes

Receba pagamentos no seu bot

Obtenha um token, crie faturas pelo código e processe um webhook a cada pagamento. Use uma chave de sandbox para testar o processo completo antes do lançamento.

10 criptomoedas · 8 redes · um só saldo Há um servidor MCP: seu agente de IA pode fazer a integração →
Tela de tokens de API e webhooks
Webhook entregue
Sandbox
Primeiros passos

Como integrar a API para comerciantes

Do token ao primeiro webhook, em quatro passos. Mais sobre a API para comerciantes →

Passo 1

Obtenha um token

Crie um aplicativo na API para comerciantes e obtenha o token de API dele.

Passo 2

Crie uma fatura

Envie o valor, a moeda e a descrição na requisição. Configure a URL do webhook separadamente, nas configurações do aplicativo.

Passo 3

Mostre o link de pagamento

Ofereça um link ou botão para o usuário abrir a página de pagamento no Telegram.

Passo 4

Processe o webhook

Ao receber o evento de pagamento, entregue o produto ou libere o acesso no seu serviço.

Agente de IA

Seu agente de IA pode fazer a integração

A API para comerciantes tem um servidor MCP. Conecte-o em um cliente de agente compatível: o agente pode ler a documentação, solicitar a criação de um app, configurar webhooks e ajudar a escrever a integração. Você aprova o app no Telegram, revisa e testa o resultado.

  1. Passo 1

    Envie o prompt ao agente

  2. Passo 2

    Aprove o app no Telegram

  3. Passo 3

    Conclua e teste a integração

Como funciona, prompts por cliente e permissões do token do agente →
Prompt para um agente com MCP
Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Crypto Merchant API.
Recursos

Pagamentos integrados ao seu produto

Crie faturas por requisição e receba os status por webhook. As próximas etapas ficam por conta do seu produto.

Token e sandbox

Use uma chave separada para testar o processo de pagamento antes de disponibilizá-lo aos usuários.

Faturas pelo código

Crie, cancele e consulte faturas com requisições HTTP. Não precisa de SDK.

Cobranças recorrentes

Ofereça assinaturas no seu serviço. O usuário autoriza uma vez e a API para comerciantes faz as cobranças nas datas previstas.

Webhooks de pagamento

O evento é enviado após o pagamento. Se a entrega falhar, há novas tentativas, até o limite previsto.

Documentação e exemplos

Consulte os métodos, códigos de erro e exemplos de requisições na Central de ajuda.

Veja como funciona na Central de ajuda

10 criptomoedas · 8 redes · um só saldo

GRAM BTC ETH SOL BNB LTC DOGE TRX
USDTTRC-20 · ERC-20 · BEP-20 · TON · SOL USDCERC-20 · BEP-20 · SOL

Tem um canal ou vende pelo Telegram?

Escolha seu perfil para conhecer os recursos que fazem sentido para você.

Para criadores Para vendedores Para desenvolvedores
Tela de confirmação do saque
Formato válido
Segurança

Confira tudo antes de enviar

O saque envia cripto para um endereço externo. Veja os dados e as etapas de segurança antes de confirmar.

  • Antes de confirmar
  • Endereço, rede e Memo Antes de confirmar, confira o endereço do destinatário, a rede e o Memo, quando necessário. Um formato válido não garante que o endereço pertença à pessoa certa.
  • Endereços salvos Se quiser, limite os saques aos endereços que você salvou previamente.
  • PIN ou Face ID Todo saque precisa de confirmação, mesmo que você já tenha confirmado outro na mesma sessão.
  • Você toca em "Confirmar"
  • Depois da confirmação
  • Atraso de segurança para saques grandes Ao ativar o atraso de segurança em Segurança, saques grandes aguardam antes do envio. Enquanto o status for Agendado, você pode cancelar.
  • Análise AML da transação A transação passa por uma análise antes do envio dos fundos.
  • Notificações de saques Você recebe notificações das operações da sua conta pelo Telegram.

Veja a seção de segurança na Central de ajuda

Condições

Saiba quanto vai pagar

O valor total e as taxas aparecem antes da confirmação. Sem taxas ocultas.

Depósitos na carteira Crédito após as confirmações da rede e as análises necessárias
Sem taxa
Transferências pelo nome de usuário no Telegram A transferência acontece dentro da carteira, sem usar a blockchain e sem taxa de rede
Sem taxa
Troque moedas na carteira Cotação, taxa e valor final na tela Trocar
Visível antes de confirmar
Saque para outra carteira Formato do endereço, rede e Memo conferidos antes do envio
Taxa de saque indicada no app

Consulte as taxas e os valores mínimos atuais no app. A lista completa está na Central de ajuda.

USDT GRAM BTC ETH SOL BNB LTC DOGE
10 criptomoedas · 8 redes — um só saldo

Você não precisa de uma carteira para cada rede. Escolha a rede que deseja usar para depositar ou sacar.

TRC-20 · ERC-20 · BEP-20 · TON · SOL · BTC · LTC · DOGE

online Suporte pelo Telegram
Meu saque pela TRC-20 ainda não chegou. O que faço? Estamos conferindo a transação. Vamos responder por aqui, nesta conversa.
@tgpayhelpbot
Dúvidas

Perguntas frequentes

Tire suas dúvidas sobre a carteira, transferências e recebimento de pagamentos.

Não. A carteira é criada na primeira vez que você abre @tgpaycryptobot. O acesso fica vinculado à sua conta do Telegram, sem login separado nem frase de recuperação. Para sacar, é preciso definir um PIN.

Você pode usar GRAM, BTC, ETH, SOL, BNB, LTC, DOGE e TRX, além de USDT em cinco redes e USDC em três. São 16 combinações de moeda e rede. Ao depositar ou sacar, escolha a rede e use o endereço correspondente.

Informe o nome de usuário. A transferência acontece dentro da carteira, sem endereço e sem taxa de rede. Se a pessoa ainda não tiver carteira, você pode enviar um cheque para ela resgatar.

Um cheque permite enviar cripto por link ou código QR. Você pode definir um ou vários resgates, senha e validade, além de limitar o resgate a assinantes dos seus canais ou usuários do Telegram Premium. Depois de criar o cheque, é possível pausar, alterar o valor e o número de resgates ou excluir. O valor restante volta para seu saldo.

Transferências pelo nome de usuário não têm taxa de rede. A taxa de saque depende da criptomoeda e da rede. Nas trocas, você vê a taxa e o valor final antes de confirmar. Consulte os valores atuais e os mínimos no app e na Central de ajuda.

Crie faturas no Telegram. Para automatizar, use a API para comerciantes: uma requisição cria a fatura e um webhook avisa quando ela é paga. A documentação dos métodos está na Central de ajuda.

Encontre todas as respostas na Central de ajuda Não encontrou a resposta? Fale com @tgpayhelpbot

Abra sua carteira em um minuto

Abra @tgpaycryptobot no Telegram. Sua carteira já estará pronta para receber cripto.

Seu perfil:
Pessoal Para criadores Para vendedores Para desenvolvedores