Como aceitar pagamentos em criptomoedas em um bot do Telegram

Para saber como aceitar pagamentos em criptomoedas num bot do Telegram, comece por definir o que o cliente está a pagar e qual o fluxo de pagamento permitido pelo Telegram. As empresas podem usar transferências diretas entre carteiras, Telegram Stars ou um gateway externo de pagamentos em criptomoedas ligado através de links de pagamento ou de uma API. Para um processo de pagamento automatizado em criptomoedas, a opção do gateway permite criar faturas, confirmar pagamentos na blockchain através de webhooks e acionar a entrega ou o acesso nos casos em que as regras do Telegram o permitam.

Resumo

• O Telegram não oferece um processo de pagamento nativo em criptomoedas para empresas; os pagamentos em criptomoedas normalmente dependem de transferências entre carteiras ou de um fornecedor externo.

• As Telegram Stars são uma moeda virtual, não uma criptomoeda, e são obrigatórias para bens e serviços digitais vendidos dentro de bots e Mini Apps do Telegram.

• As transferências entre carteiras são simples, mas geralmente exigem reconciliação manual.

• Um gateway de pagamentos em criptomoedas pode automatizar faturas, atualizações de pagamento e o processamento de pedidos nos casos em que são permitidos métodos de pagamento de terceiros.

3 formas de as empresas receberem efetivamente pagamentos em criptomoedas através do Telegram

Os pagamentos em criptomoedas através do Telegram podem corresponder a três fluxos muito diferentes. Cada método tem implicações distintas em termos de automatização, conformidade e regras da plataforma.

Atualmente, o Telegram exige a utilização de Telegram Stars para bens e serviços digitais vendidos dentro dos seus bots e Mini Apps. Por isso, uma API de pagamentos em criptomoedas de terceiros não deve ser apresentada como uma forma de contornar as Stars para produtos digitais dentro da aplicação. Para bens físicos e serviços elegíveis, podem estar disponíveis outros métodos de pagamento.

Metodologia

Este guia utiliza a documentação oficial do Telegram sobre pagamentos em bots e Stars, bem como a documentação atual da API de pagamentos da PassimPay. Os exemplos seguem o fluxo de pagamento desde a criação de um pedido de pagamento até à receção de uma atualização de estado, à verificação do callback e ao acionamento do processamento do pedido.

A secção sobre conformidade fornece apenas informações gerais e não constitui aconselhamento jurídico, fiscal ou regulamentar.

Porquê aceitar pagamentos em criptomoedas através do Telegram?

Um bot do Telegram pode combinar a interação com o cliente e o início do pagamento num único fluxo. Pode apresentar uma fatura ou um link de pagamento, aguardar a confirmação e dar continuidade ao percurso do cliente após a confirmação do pagamento.

Para públicos internacionais, as criptomoedas oferecem outro canal de pagamento nos casos em que tanto o comerciante como o cliente as podem utilizar legalmente. Os clientes podem pagar com criptomoedas suportadas sem depender de um fluxo de pagamento por cartão.

A automatização é uma das principais razões para utilizar uma API de pagamentos para bots do Telegram em vez de simplesmente publicar um endereço de carteira. O bot pode associar um ID de pedido a um pedido de pagamento, receber um webhook quando o estado muda, atualizar o pedido e acionar automaticamente a ação seguinte.

Isto é particularmente útil quando os comerciantes processam mais do que um pequeno número de transações. A reconciliação manual das carteiras pode funcionar para pagamentos ocasionais, mas torna-se mais difícil de gerir quando vários clientes enviam montantes semelhantes ao mesmo tempo.

As transações confirmadas na blockchain também não utilizam o mesmo mecanismo de estorno das redes de cartões que os pagamentos por cartão. Ainda assim, os comerciantes precisam de procedimentos de reembolso, apoio ao cliente, controlos antifraude e condições de pagamento claras.

O gateway de pagamentos em criptomoedas PassimPay fornece uma infraestrutura de pagamentos que pode ser ligada a um bot do Telegram. A PassimPay suporta 74 criptomoedas e 18+ blockchains, taxas a partir de 0.5%, links de pagamento & códigos QR, API de pagamentos e webhooks & notificações.

Como aceitar pagamentos em criptomoedas num bot do Telegram, passo a passo

A integração adequada de um bot de pagamentos do Telegram depende de precisar de um fluxo de pagamento simples ou de um processo de pagamento totalmente automatizado. Os links de pagamento exigem menos desenvolvimento, enquanto a integração por API dá ao bot controlo direto sobre a criação de pagamentos, o acompanhamento do estado e o processamento de pedidos.

Opção 1: Comece com um link de pagamento ou um código QR

• Crie uma conta de comerciante e conclua a verificação.

Registe-se junto do fornecedor de pagamentos e conclua a verificação empresarial ou de identidade exigida. O processo exato de adesão pode depender do fornecedor, da entidade comerciante, da jurisdição e do perfil de risco.

• Crie o pedido de pagamento.

Use Payment Links & QR Codes para gerar um link de pagamento ou código QR com o valor necessário. Com a PassimPay, o comerciante pode criar uma solicitação de pagamento sem desenvolver uma interface de checkout personalizada.

• Envie o link de pagamento pelo Telegram.

O bot ou um administrador pode enviar o link de pagamento diretamente em uma conversa privada ou em outro fluxo adequado do Telegram. O cliente abre o link, seleciona a opção de pagamento disponível e envia o valor necessário.

Mantenha uma referência do pedido no seu próprio sistema para que a transação possa ser associada ao cliente e à compra corretos.

• Confirme o pagamento antes de atender ao pedido.

Para um pequeno número de transações, o comerciante pode verificar o pagamento no painel do provedor antes de entregar o produto ou prestar o serviço.

Essa abordagem é relativamente simples de implementar porque não exige uma integração completa com a API de pagamentos para bots do Telegram. No entanto, a verificação manual se torna ineficiente à medida que o volume de transações aumenta.

Opção 2: Desenvolva uma integração completa com a API de pagamentos para bots do Telegram

A integração por API é mais adequada quando o bot precisa gerar solicitações de pagamento e processar os status dos pagamentos automaticamente.

• Configure o acesso à API e conecte o bot à criação de pagamentos.

Após criar a conta de comerciante, configure a plataforma necessária e obtenha as credenciais exigidas para as solicitações à API, como uma chave de API e um identificador da plataforma. A PassimPay exige que as solicitações à API sejam assinadas, com a assinatura incluída nos cabeçalhos da solicitação.

Armazene as credenciais da API no servidor. Elas não devem ser expostas em mensagens do Telegram, no código de front-end de Mini Apps ou em outros componentes do lado do cliente.

Quando um cliente seleciona um produto ou serviço, o bot do Telegram envia a solicitação ao seu back-end, que então se comunica com o provedor de pagamentos. Dependendo do modelo de integração, o provedor pode retornar um endereço de pagamento em criptomoeda ou um link de fatura que o bot envia ao cliente.

• Associe cada pagamento a um pedido.

Crie um identificador de pedido exclusivo para cada solicitação de pagamento. Ele deve permitir que o seu sistema relacione o usuário do Telegram, o produto ou serviço, o valor esperado, a criptomoeda selecionada e o status do pagamento.

Isso é importante porque vários clientes podem pagar aproximadamente ao mesmo tempo. O valor, por si só, não deve ser usado como a principal forma de identificar um pedido.

• Configure e verifique os webhooks.

Defina uma URL de notificação que aponte para um endpoint controlado pelo comerciante. Quando o status do pagamento muda, o provedor envia um webhook para esse endpoint, permitindo que o back-end atualize o pedido correspondente.

Na PassimPay, a URL de notificação é configurada nas configurações da plataforma. Antes de processar um webhook, verifique o cabeçalho x-signature e confira se o endereço IP do remetente está entre os endereços IP autorizados da PassimPay. Solicitações de endereços IP desconhecidos ou não autorizados não devem ser aceitas.

• Trate as notificações duplicadas e retorne HTTP 200.

O processamento de webhooks deve ser idempotente para que a mesma transação não possa acionar o atendimento do pedido mais de uma vez.

Isso é particularmente relevante para BTC, LTC, DASH, Dogecoin e Bitcoin Cash. A PassimPay pode enviar até duas notificações de webhook para a mesma transação: uma após a primeira confirmação e outra após a segunda. Se a transação for detectada pela primeira vez após duas confirmações, apenas uma notificação poderá ser enviada.

Após processar com sucesso um callback de depósito válido, o servidor deve retornar HTTP 200. Se a PassimPay não receber HTTP 200, poderão ser feitas duas tentativas adicionais de entrega do webhook.

• Acione o atendimento do pedido e teste o fluxo completo.

Assim que o status de pagamento necessário for confirmado, atualize o pedido e instrua o bot a continuar o fluxo do cliente. Dependendo do caso de uso, isso pode significar confirmar um pedido, agendar a entrega, notificar um administrador ou executar outra ação de serviço permitida. 

Não marque um pedido como pago apenas porque o cliente envia uma captura de tela ou um hash de transação. Antes do lançamento, teste pagamentos bem-sucedidos, confirmações atrasadas, callbacks duplicados, assinaturas inválidas, erros temporários do servidor e casos em que um cliente cria uma solicitação de pagamento, mas nunca a conclui.

Payment API e Payment Links & QR Codes da PassimPay abrangem os dois modelos de integração: links de pagamento para uma implementação mais simples e processamento baseado em API para fluxos de trabalho automatizados.

Telegram Stars versus pagamentos em criptomoedas

Telegram Stars e pagamentos em criptomoedas têm finalidades diferentes.

Telegram Stars são itens virtuais usados dentro do Telegram. Os usuários adquirem Stars pelos fluxos de compra compatíveis do Telegram e podem usá-las para pagar por bens e serviços digitais oferecidos por bots e Mini Apps.

Stars não são criptomoedas. Seu fluxo de pagamento é controlado pelo Telegram, e o Telegram exige seu uso para bens e serviços digitais vendidos dentro de seus aplicativos.

Os pagamentos em criptomoedas usam ativos de blockchain como BTC, USDT, ETH ou outras criptomoedas compatíveis. Normalmente, eles exigem uma carteira externa ou um provedor de pagamentos.

Um gateway de pagamentos em criptomoedas para o Telegram pode conectar o bot a esse fluxo de pagamento em blockchain, mas a possibilidade de o comerciante usar um método de pagamento externo depende do que está sendo vendido.

A mesma distinção se aplica aos pagamentos em Mini Apps do Telegram. Criar um Mini App não gera uma exceção para produtos digitais cujo pagamento o Telegram exige que seja feito em Stars.

Para bens físicos e serviços elegíveis, provedores de pagamentos externos podem ser usados quando as regras do Telegram e as leis aplicáveis permitirem.

Conformidade, segurança e escalabilidade

Aceitar pagamentos em criptomoedas pelo Telegram significa que a empresa está combinando uma interface de mensagens com uma infraestrutura de pagamento externa. Ambas as partes do fluxo precisam ser consideradas no planejamento de conformidade, contabilidade e segurança.

Verifique a jurisdição da empresa

Os requisitos podem depender de onde o comerciante está registrado, onde os clientes estão localizados, o que a empresa vende e como as criptomoedas são gerenciadas após o pagamento.

A simples aceitação de criptomoedas como pagamento e a prestação de serviços regulamentados de criptomoedas nem sempre recebem o mesmo tratamento. As empresas devem determinar quais regras se aplicam ao seu modelo específico.

Planeje os procedimentos de KYC e AML

Um provedor de pagamentos pode exigir a verificação do comerciante antes de processar pagamentos.

Os provedores também podem usar o monitoramento de AML para analisar as transações recebidas. A PassimPay declara que está registrada na FINTRAC sob o número de registro C100000852 e aplica verificações de AML às transações antes de os fundos serem creditados.

A necessidade de verificação adicional dos clientes pode depender do provedor, da jurisdição, do tipo de transação e dos requisitos de conformidade aplicáveis.

Mantenha registros dos pagamentos

Os pagamentos em criptomoedas também precisam ser registrados para fins contábeis e de elaboração de relatórios.

As empresas devem manter informações relevantes, como:

• ID do pedido;

• criptomoeda e blockchain;

• valor em criptomoeda;

• valor aplicável em moeda fiduciária;

• hash da transação;

• horário do pagamento;

• taxas do provedor;

• detalhes da liquidação;

• reembolsos, quando aplicável.

O tratamento contábil e fiscal exigido depende da jurisdição.

Gerencie a volatilidade das criptomoedas

Se um bot receber pagamentos em ativos voláteis, como BTC, o valor desses fundos poderá mudar após a transação.

Os comerciantes precisam decidir se desejam manter a criptomoeda original ou converter os pagamentos recebidos em outro ativo.

A PassimPay oferece a Conversão Automática para Stablecoins, que pode converter os pagamentos recebidos em USDT ou USDC. As empresas que preferem receber pagamentos diretamente em stablecoins também podem usar um gateway de pagamento em USDT.

Proteja as credenciais de API e os endpoints de webhook

As chaves de API devem permanecer no servidor e nunca devem ser enviadas aos clientes nem armazenadas em código do bot acessível publicamente.

As assinaturas dos webhooks devem ser verificadas antes de alterar o status de um pedido. Os comandos administrativos do bot também devem ser protegidos contra usuários não autorizados.

Os eventos de pagamento devem ser registrados para que o comerciante possa investigar posteriormente transações com falha ou contestadas.

Prepare-se para o aumento de escala

Uma configuração que funciona para dez pagamentos pode não funcionar para milhares.

Monitore falhas em callbacks, atrasos nas confirmações da blockchain, redes indisponíveis, períodos de inatividade do provedor e atividades de pagamento incomuns.

As empresas também devem ter um processo de contingência para os casos em que a entrega automática falhe, mesmo que o pagamento em si tenha sido confirmado.

Estas são informações gerais, não aconselhamento jurídico. Consulte um profissional habilitado nas áreas jurídica, fiscal ou de conformidade para conhecer os requisitos aplicáveis à sua jurisdição e ao seu modelo de negócio.

Perguntas frequentes

Posso aceitar pagamentos em criptomoedas diretamente no Telegram sem um site separado?

Nem sempre é necessário ter um site separado. Um bot pode enviar um link externo de pagamento em criptomoedas ou se conectar a uma API de pagamento. No entanto, os produtos e serviços digitais vendidos nos bots e Mini Apps do Telegram devem atualmente usar Telegram Stars, conforme as regras da plataforma Telegram.

Qual é a diferença entre Telegram Stars e pagamentos em criptomoedas?

Telegram Stars são itens virtuais usados dentro do Telegram e não são criptomoedas. Os pagamentos em criptomoedas usam ativos de blockchain, como BTC ou USDT. O Telegram exige Stars para produtos e serviços digitais dentro do aplicativo, enquanto outros métodos de pagamento podem ser aplicáveis a produtos físicos ou serviços elegíveis.

É legal aceitar pagamentos em criptomoedas por meio de um bot do Telegram?

A legalidade depende da jurisdição do comerciante, da localização dos clientes, do produto e do fluxo de pagamento. Aceitar criptomoedas pode gerar obrigações fiscais, contábeis, de proteção ao consumidor, de AML ou de licenciamento. As empresas devem analisar as regras locais e os termos do provedor antes de lançar um fluxo de pagamento em criptomoedas no Telegram.

Como integro uma API de pagamento em criptomoedas ao meu bot do Telegram?

Conecte o backend do bot à API de um provedor de pagamentos, crie uma fatura ou um endereço de pagamento para cada pedido, armazene uma referência exclusiva do pedido, receba um webhook assinado após o pagamento, verifique-o no servidor, atualize o pedido e, em seguida, acione a entrega.

Com que rapidez os pagamentos em criptomoedas são confirmados ao usar um bot do Telegram?

A velocidade de confirmação depende principalmente da blockchain, da quantidade de confirmações exigidas, das condições da rede e do processamento do provedor. O bot do Telegram em si não determina o tempo de liquidação na blockchain. Alguns pagamentos podem ser atualizados em segundos, enquanto outros podem exigir vários minutos ou mais.

Preciso de verificação KYC para aceitar pagamentos em criptomoedas no Telegram?

Um provedor de pagamentos normalmente exige a verificação do comerciante antes de habilitar os serviços de pagamento. A necessidade de os clientes também passarem por KYC depende do provedor, da jurisdição, do tipo de transação e dos controles de risco. A verificação da conta do Telegram não substitui as verificações de conformidade do provedor de pagamentos.

Leituras relacionadas

• Como aceitar pagamentos em criptomoedas no seu site WordPress

• Produtos PassimPay

Considerações finais

A resposta prática sobre como aceitar pagamentos em criptomoedas num bot do Telegram é separar a camada de mensagens da infraestrutura de pagamentos. O Telegram gere a interação com o cliente, enquanto um gateway de pagamentos em criptomoedas para o Telegram pode tratar dos pedidos de pagamento, da confirmação na blockchain, dos webhooks e dos registos de transações para os fluxos de pagamento elegíveis.

Para volumes baixos de pagamentos, os links de pagamento e os códigos QR podem proporcionar um ponto de partida mais simples. Para o processamento automatizado, os comerciantes podem ligar uma API de pagamentos para bots do Telegram ao seu backend e usar o estado verificado do pagamento como gatilho para a ação seguinte.

Antes do lançamento, confirme as regras do Telegram aplicáveis ao que vende, verifique o fornecedor de pagamentos e o fluxo de integração e certifique-se de que estão assegurados a conformidade, a contabilidade, a segurança e o tratamento de pagamentos falhados.