Pular para o conteúdo
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Adicionando um Projeto

Saiba como adicionar corretamente um projeto à Trybit.

Um projeto no Trybit é um ponto separado de aceitação de pagamentos: um site, um bot do Telegram ou uma página de doação — com suas próprias chaves, configurações e estatísticas. O tipo é escolhido uma única vez na criação e determina quais campos e etapas de configuração você seguirá em seguida.

Tipos de projeto

Ao adicionar um projeto, você precisa escolher como vai aceitar pagamentos — isso determina o conjunto de campos do formulário:

  • Site — se você aceita pagamentos em um site. Será necessária integração (veja a Integração seção).

  • Bot do Telegram — se você aceita pagamentos por meio de um bot do Telegram. Um tipo de projeto separado. Será necessária integração.

  • Doações — se você quiser aceitar doações em uma página separada do Trybit. Não é necessária integração — mais detalhes na página Aceitando Doações . O método de pagamento para doações não é adequado para atividade comercial — ele se destina apenas a doações voluntárias e não pode ser usado para pagar por bens, serviços ou quaisquer transações comerciais.

Importante: o tipo de projeto não pode ser alterado depois que o projeto é criado — escolha com cuidado na primeira etapa do processo de adição de projeto.

Posso adicionar vários projetos a uma conta

Sim. Você pode criar e gerenciar vários projetos dentro de uma única conta — por exemplo, para diferentes linhas de negócio ou diferentes sites. Cada projeto é configurado de forma independente: suas próprias moedas, taxas, integração e página de pagamento.

Como adicionar um projeto para aceitar pagamentos em um site

O processo de adição de projeto consiste em 6 etapas: Tipo de Projeto → Sobre o Projeto → Verificação → Integração e API → Chaves e Pagamentos de Teste → Revisão e Envio.

  1. Tipo de Projeto — selecione "Site." O tipo de projeto afeta o conjunto de campos e a ordem da análise. O tipo não pode ser alterado depois que o projeto é criado.

  2. Sobre o Projeto: Nome do projeto — exibido na página de pagamento, nos comprovantes dos clientes e no seu painel. Insira o nome da forma como seus clientes o conhecem.

    Ramo de atividade — escolha a categoria mais próxima. Ela deve corresponder à atividade real do seu projeto.

    Descrição do projeto — de 100 a 250 caracteres; descreva em detalhes seu nicho, produtos ou serviços e mercado-alvo. Formulações genéricas como "vendemos produtos" retardam a análise.

    Faturamento esperado — uma estimativa do volume mensal de pagamentos. Forneça um valor realista — isso acelera a análise.

    Domínio — um link para o site ativo onde os pagamentos serão aceitos. Você precisará verificá-lo na próxima etapa. Depois que você avançar para a próxima etapa, o link não poderá mais ser alterado.

    Canal de contato — forneça um contato que você verifique regularmente. Nosso gerente e a equipe de suporte ajudarão na integração, responderão às dúvidas e resolverão rapidamente quaisquer problemas. Também usaremos esse contato para falar com você caso surjam dúvidas durante a moderação.

  3. Verificação — confirmação da propriedade do domínio usando um de três métodos (à sua escolha): DNS — adicione um registro TXT com o valor fornecido ao DNS do domínio; Meta tag — coloque a tag fornecida na página inicial; Arquivo HTML — envie um arquivo com o conteúdo fornecido para a pasta raiz do site. A verificação é automática e leva até um minuto.

  4. Integração e API — escolha um método de conexão: API → Integração direta via API. Controle total sobre o fluxo de pagamento. A verificação por POSTBACK será necessária em seguida.

    Plugins de CMS → Módulos prontos para plataformas CMS populares. As URLs são preenchidas automaticamente. A verificação por POSTBACK será necessária em seguida.

    Widget HTML (com POSTBACK) → Um widget para o seu site. Envia notificações de postback sobre o status do pagamento. A verificação por POSTBACK será necessária em seguida.

    Widget HTML (sem POSTBACK) → Um widget para o seu site sem notificações de postback. A verificação por POSTBACK não é necessária.

  5. Chaves e Pagamento de Teste — nesta etapa, são emitidas a chave API do projeto, o Shop ID e a chave secreta. Você precisará deles para concluir a integração. A integração pode ser feita usando um dos métodos disponíveis (veja a Métodos de Integração seção). Depois de concluir a integração, você precisa testar o recebimento de POSTBACK (veja a Testando sua Integração seção). Você só pode enviar uma solicitação para sair do modo de teste depois de testar com sucesso a sua integração.

  6. Revisão e Envio — uma verificação final dos dados inseridos antes de enviá-los para moderação. Não deixe de revisar os requisitos e restrições do projeto e conferir todos os dados que você inseriu. Envie sua solicitação para sair do modo de teste — a análise leva até 24 horas após o envio. Você pode acompanhar o status da solicitação no seu painel. Uma vez aprovada, você receberá uma notificação por e-mail e poderá começar a aceitar pagamentos em criptomoedas no seu site ou plataforma. Se a solicitação for recusada, será informado um motivo. Dependendo do motivo, você poderá fazer alterações e reenviar a solicitação.

Após concluir todas as etapas, o projeto aparece em "Meus Projetos." Até que a solicitação para sair do modo de teste seja aprovada, o projeto permanece automaticamente no modo de teste.

Como adicionar um projeto para aceitar pagamentos via Bot do Telegram

O processo de adição de projeto consiste em 6 etapas: Tipo de Projeto → Sobre o Projeto → Verificação → Integração e API → Chaves e Pagamentos de Teste → Revisão e Envio.

  1. Tipo de Projeto — selecione "Bot do Telegram." O tipo de projeto afeta o conjunto de campos e a ordem da análise. O tipo não pode ser alterado depois que o projeto é criado.

  2. Sobre o Projeto: Nome do projeto — exibido na página de pagamento, nos comprovantes dos clientes e no seu painel. Insira o nome da forma como seus clientes o conhecem.

    Ramo de atividade — escolha a categoria mais próxima. Ela deve corresponder à atividade real do seu projeto.

    Descrição do projeto — de 100 a 250 caracteres; descreva em detalhes seu nicho, produtos ou serviços e mercado-alvo. Formulações genéricas como "vendemos produtos" retardam a análise.

    Faturamento esperado — uma estimativa do volume mensal de pagamentos. Forneça um valor realista — isso acelera a análise.

    Link do bot — um link direto para o bot ou seu @username. Você precisará verificá-lo na próxima etapa. Depois que você avançar para a próxima etapa, o link não poderá mais ser alterado. Canal de contato — forneça um contato que você verifique regularmente. Nosso gerente e a equipe de suporte ajudarão na integração, responderão às dúvidas e resolverão rapidamente quaisquer problemas. Também usaremos esse contato para falar com você caso surjam dúvidas durante a moderação.

  3. Verificação — abra o @BotFather, use o comando /setabouttext, selecione seu bot, cole o código e clique em "Verificar". O Telegram atualiza os dados do bot em poucos minutos.

  4. Integração e API — escolha um método de conexão: API → Integração direta via API. Controle total sobre o fluxo de pagamento. A verificação por POSTBACK será necessária em seguida.

  5. Chaves e Pagamento de Teste — nesta etapa, são emitidas a chave API do projeto, o Shop ID e a chave secreta. Você precisará deles para concluir a integração. Depois de concluir a integração via API, você precisa testar o recebimento de POSTBACK (veja a Testando sua Integração seção). Você só pode enviar uma solicitação para sair do modo de teste depois de testar com sucesso a sua integração.

  6. Revisão e Envio — uma verificação final dos dados inseridos antes de enviá-los para moderação. Não deixe de revisar os requisitos e restrições do projeto e conferir todos os dados que você inseriu. Envie sua solicitação para sair do modo de teste — a análise leva até 24 horas após o envio. Você pode acompanhar o status da solicitação no seu painel. Uma vez aprovada, você receberá uma notificação por e-mail e poderá começar a aceitar pagamentos em criptomoedas no seu site ou plataforma. Se a solicitação for recusada, será informado um motivo. Dependendo do motivo, você poderá fazer alterações e reenviar a solicitação.

Após concluir todas as etapas, o projeto aparece em "Meus Projetos." Até que a solicitação para sair do modo de teste seja aprovada, o projeto permanece automaticamente no modo de teste.

Como adicionar um projeto para aceitar Doações

O método de pagamento para doações destina-se apenas a doações voluntárias e não pode ser usado para pagar por bens, serviços ou quaisquer transações comerciais.

O processo de adição de projeto consiste em 4 etapas: Tipo de Projeto → Sobre o Projeto → Verificação → Revisão e Envio.

  1. Tipo de Projeto — selecione "Doações." O tipo de projeto afeta o conjunto de campos e a ordem da análise. O tipo não pode ser alterado depois que o projeto é criado.

  2. Sobre o Projeto: Nome do projeto — exibido na página de pagamento, nos comprovantes dos clientes e no seu painel. Insira o nome da forma como seus clientes o conhecem.

    Ramo de atividade — escolha a categoria mais próxima. Ela deve corresponder à atividade real do seu projeto.

    Descrição do projeto — de 100 a 250 caracteres; descreva em detalhes seu nicho, produtos ou serviços e mercado-alvo. Formulações genéricas como "vendemos produtos" retardam a análise.

    Link de rede social — é importante indicar os perfis nos quais você está construindo sua audiência. Eles só podem ser alterados no modo de teste.

  3. Verificação — confirmação da propriedade do perfil/bot especificado: coloque o código de verificação fornecido na descrição do perfil ou do bot.

  4. Revisão e Envio — uma verificação final dos dados inseridos antes de enviá-los para moderação. Envie sua solicitação para sair do modo de teste — a análise leva até 24 horas após o envio. Você pode acompanhar o status da solicitação no seu painel. Uma vez aprovada, você receberá uma notificação por e-mail e poderá começar a aceitar pagamentos em criptomoedas no seu site ou plataforma. Se a solicitação for recusada, será informado um motivo. Dependendo do motivo, você poderá fazer alterações e reenviar a solicitação.

Após concluir todas as etapas, o projeto aparece em "Meus Projetos." Até que a solicitação para sair do modo de teste seja aprovada, o projeto permanece automaticamente no modo de teste.

O que pode ser alterado depois que um projeto é criado

Antes de sair do modo de teste após a criação do projeto, apenas as seções "Moedas do Projeto" e "Taxas" podem ser editadas. Depois que o modo de teste for removido e o projeto se tornar ativo, as demais seções serão liberadas: "Autoconversão", "Carteiras Estáticas", "Construtor de Página de Pagamento", "Configurações de PDV" e "Widget de Pagamento."

Depois de sair do modo de teste, você pode fazer alterações livremente nas configurações do projeto sem precisar reativar o modo de teste — com exceção da seção "Integração e API": o formato do POSTBACK, as URLs de pagamento de sucesso/erro, a URL de notificação e o método de integração não podem ser alterados. Além disso, o nome do projeto, o ramo de atividade e a descrição do projeto só podem ser alterados enquanto estiver em modo de teste.

Aplica-se também uma restrição separada à URL do site ou ao bot do Telegram — esses dados também não podem ser alterados nem no modo de teste nem depois de sair dele. Se você precisar informar um site ou bot diferente, será necessário criar um novo projeto.

Atualizado