Pular para o conteúdo principal

Receber pagamentos no Telegram

Esta solução é para serviços que vendem pelo Telegram: um bot que envia links de pagamento no chat ou um mini app, um app web que abre dentro do Telegram. Seus clientes pagam sem sair do Telegram, o bot confirma o pedido no chat e o dinheiro cai no seu saldo da Volet.com, pronto para sacar ou pagar parceiros.

Para quem é​

Esta solução serve para você se:

  • Vende por um bot um serviço usado fora do Telegram: VPN, hospedagem, um produto SaaS, consultoria, aulas ou uma reserva.
  • Vende produtos físicos por um bot ou mini app.
  • Permite que os usuários recarreguem pelo Telegram um saldo no seu próprio serviço.
  • Paga parceiros ou usuários com o dinheiro que o seu bot arrecada.

Uma conta pessoal é suficiente. Você só precisa de uma conta Business se os pagamentos tiverem de ser feitos em nome de uma empresa ou se seus volumes ultrapassarem os limites de uma conta pessoal. Veja Escolher conta pessoal ou empresarial.

Considere outra opção se:

  • Você vende bens digitais ou conteúdo usados dentro do próprio Telegram: posts pagos, itens de jogos, acesso a um canal privado. O Telegram exige a própria moeda, Telegram Stars, para eles; veja O que o Telegram permite abaixo.
  • Você toca o bot sozinho e está começando. Veja Lançar um serviço on-line pago; tudo o que esta página diz sobre o Telegram também vale.
  • Você também paga prestadores de serviço, parceiros ou usuários com o mesmo saldo. Veja Permitir depósitos e saques dos usuários para a parte dos pagamentos.

O que o Telegram permite​

O Telegram exige Telegram Stars para bens e serviços digitais vendidos e usados dentro de um bot ou mini app. Você não pode vendê-los por cripto por meio de um gateway de pagamento. Veja os pagamentos de bens digitais e os Termos para desenvolvedores de bots do Telegram.

Um gateway de pagamento como a Volet.com serve para todo o resto: serviços usados fora do Telegram, produtos físicos, recargas de saldo no seu próprio serviço, pagamentos a parceiros e acertos entre empresas.

O que você pode fazer​

Receber pagamentos

Guardar e usar o dinheiro

  • Receba cada pagamento na moeda que você escolher, qualquer que seja a moeda usada pelo cliente; USD, USDT e USDC são convertidos 1:1. — Liquidação e conversão automática
  • Pague parceiros ou usuários com o mesmo saldo ou saque para uma conta bancária, um cartão ou uma carteira cripto. — Sacar ou enviar fundos

Quem faz o quê​

Precisa deVê e fazResponsável por
VocêUma conta verificada da Volet.com, pessoal ou Business, um gateway de pagamento aprovado, um bot criado no @BotFather, um backendCria a solicitação de pagamento, envia o botão de pagamento ou abre a página de pagamento, confirma o pedido no chatCumprir as regras do Telegram, seu produto e a entrega, reembolsos, suporte aos clientes no bot
Seus clientesTelegram e uma carteira cripto ou uma conta da Volet.comTocam o botão no chat ou pagam dentro do mini app, veem a página de pagamento da Volet.com com o endereço do seu botPagar na rede mostrada na página
Telegram—Hospeda o seu bot e o mini appAs próprias regras para pagamentos em bots, incluindo Telegram Stars para bens digitais
Volet.com—Hospeda a página de pagamento, monitora a blockchain, faz a verificação AML da cripto recebida, converte moedas, notifica o seu backendProcessamento de pagamentos e suporte em questões de pagamento. Não entrega o seu produto nem reembolsa seus clientes

Como o dinheiro circula​

  1. O cliente escolhe um produto no seu bot ou mini app.
  2. O seu backend cria uma solicitação de pagamento na Volet.com e salva o ID de usuário do Telegram junto com o pedido.
  3. O bot envia um botão de pagamento, ou o mini app abre a página de pagamento.
  4. O cliente paga em cripto ou com o saldo da Volet.com. No caso de cripto, a Volet.com aguarda as confirmações da rede e verifica o pagamento.
  5. O pagamento é creditado na sua conta na sua moeda de liquidação e fica disponível na hora.
  6. A Volet.com envia uma notificação ao seu backend; o bot confirma o pedido no chat e entrega o produto.

Como configurar​

Etapa 1: criar um gateway de pagamento​

Comece pelo Hosted Checkout: a página de pagamento é hospedada pela Volet.com, funciona dentro de um mini app e aceita pagamentos em cripto e com saldo. Escolha a API se quiser que a tela de pagamento faça parte do seu chat ou mini app. Nas configurações do gateway, informe o endereço do seu bot, ative a assinatura digital, decida se aceita pagamentos a menor e a maior e defina a Status URL do seu backend. A aprovação costuma levar algumas horas. Veja Criar um gateway de pagamento e Escolher um método de integração.

Etapa 2: criar um bot no Telegram​

  1. Abra o @BotFather no Telegram e crie um bot com o comando /newbot.
  2. Guarde o token do bot. O seu backend o usa para enviar mensagens pela Telegram Bot API.
  3. Para abrir uma interface web dentro do Telegram, crie um mini app no @BotFather e defina a URL do seu app web. Veja Telegram Mini Apps.

Para um primeiro bot, siga o tutorial de bots do Telegram.

Etapa 3: mostrar a página de pagamento​

  • No chat do bot: envie uma mensagem com um botão inline que abre a sua URL de pagamento. Veja InlineKeyboardButton.
  • Em um mini app: abra a página do Hosted Checkout dentro do mini app ou no navegador do dispositivo com Telegram.WebApp.openLink. Veja Telegram Mini Apps.

O seu backend cria a solicitação de pagamento antes de a página abrir, para que o bot consiga relacionar o pagamento ao pedido. Veja Integração do Hosted Checkout.

Etapa 4: confirmar o pedido no chat​

Quando o seu backend receber a notificação de pagamento e verificar a assinatura, envie uma mensagem do bot ao cliente e entregue o produto. Não dependa de o cliente voltar ao chat ou ao mini app.

Etapa 5: receber o primeiro pagamento pelo bot​

A Volet.com não oferece sandbox, então o primeiro pagamento é real: pague você mesmo um valor pequeno pelo bot, de uma carteira cripto e de uma conta da Volet.com, e confira se a confirmação chega ao chat. Integrar um bot pequeno leva cerca de um dia. A partir daí, cada venda cai no seu saldo; saque, mantenha em stablecoins ou use para pagar parceiros. Veja Sacar ou enviar fundos.

Opção de autocustódia​

Em um mini app, os clientes também podem pagar direto da carteira deles para a sua, por um contrato inteligente da Volet.com. Isso serve para bots voltados a um público nativo de cripto e para projetos que precisam guardar os fundos por conta própria.

  1. O mini app conecta a carteira do cliente. O Telegram exige TON Connect para conexões de carteira dentro de um mini app.
  2. O cliente confirma o pagamento na carteira dele, em USDT, USDC ou um token nativo em uma rede suportada, TON inclusive.
  3. O pagamento chega à sua carteira; o seu backend verifica a transação na blockchain e o bot confirma o pedido no chat.
  4. Para sacar em fiat ou pagar parceiros pela Volet.com, envie parte da cripto para a sua conta da Volet.com. Um depósito para um endereço permanente da sua carteira cripto, na mesma moeda, não tem taxa da Volet.com. Veja Depositar com cripto.

O que muda: os clientes pagam só com carteiras e pagam as taxas de rede; não há conversão automática; a configuração é feita individualmente com a equipe comercial, que também pode adaptar o contrato à lógica do seu bot, por exemplo assinaturas ou acesso condicionado à posse de tokens. Veja Desenvolvimento de contratos inteligentes sob medida. Veja Receber pagamentos cripto não custodiais e Receber cripto na sua própria carteira.

No dia a dia​

  • Assinaturas. Pagamentos em cripto não são cobrados automaticamente todo mês. Deixe os clientes recarregarem um saldo no seu serviço e desconte a assinatura dele no seu calendário, ou envie um novo botão de pagamento antes de cada período.
  • Pagamentos atrasados ou a menor. Uma solicitação de pagamento em cripto vale por 60 minutos sem conversão e 15 minutos com conversão. Um pagamento atrasado é devolvido ao cliente ou, em alguns casos, creditado a você. As suas configurações de pagamento a menor e a maior decidem se um valor menor ou maior conclui o pedido. Veja Tratamento de pagamentos.
  • "Paguei, mas o bot não responde." Confira o status do pedido no seu backend ou pela API antes de responder; o cliente pode ter pago em outra rede ou depois que a solicitação expirou. Veja O cliente diz que o pagamento foi confirmado, mas o pedido não está pago.
  • Reembolsos. A Volet.com não cancela pagamentos concluídos. Reembolse os clientes você mesmo, por exemplo com uma transferência para a conta deles na Volet.com ou com um pagamento em cripto.
  • Bots falsos. Informe aos clientes qual é o seu bot e nunca peça que conectem uma carteira ou paguem fora do seu bot e do seu mini app oficiais.
  • Contabilidade. Baixe extratos e guarde o ID de usuário do Telegram e o ID do pedido com cada pagamento. Veja Extratos.

Bom saber​

  • As regras do Telegram vêm primeiro. Bens digitais usados dentro do Telegram são pagos em Telegram Stars. Se você recebe pagamentos da carteira do próprio cliente dentro de um mini app (pagamentos não custodiais), o Telegram exige TON Connect para a conexão da carteira. Pagamentos pelo Hosted Checkout ou pela API não conectam carteira.
  • Análise do gateway. A Volet.com analisa cada gateway novo e o bot ou site que ele atende.
  • Verificação AML. Os pagamentos em cripto recebidos são verificados, normalmente dentro do tempo de processamento habitual. Veja Verificação de transações.
  • Transações definitivas. Pagamentos confirmados na blockchain não podem ser cancelados nem revertidos.
  • Limites. Seus limites atuais aparecem antes de você confirmar cada transação. Veja Limites.

Custos​

TaxaQuem pagaQuando
Taxa de processamentoVocê; nos pagamentos com saldo, pode somá-la ao valor do clienteEm cada pagamento
Taxa de rede do pagamento em criptoSeu clienteQuando paga em cripto
ConversãoVocêQuando o cliente paga em uma moeda diferente da sua moeda de liquidação, exceto nas conversões 1:1 entre USD, USDT e USDC
Taxas de saque ou de pagamentoVocêQuando você saca ou paga parceiros

Não há taxas de adesão nem mensalidades do lado da Volet.com. Veja a página de taxas para empresas. A taxa exata sempre aparece antes de você confirmar.

Quando você crescer​

Para as ofertas atuais, consulte a página de produto do gateway de pagamento cripto.