> For the complete documentation index, see [llms.txt](https://support.trybit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.trybit.com/pt-br/getting-started/add-project.md).

# 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](https://support.trybit.com/pt-br/integration.md) 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](https://support.trybit.com/pt-br/payments/donation-page.md) . 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.

<figure><img src="https://1820663065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlibkdeN79Y0EFrnLB1c%2Fuploads%2FWDFCLHzFnhxOq61NS0Oa%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-10-14%20%D0%B2%2018.12.23.png?alt=media&amp;token=ed5114a4-e9b4-4f50-be4f-155eaf9fc589" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**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.
{% endhint %}

### 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.<br>

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

   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.<br>

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

   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.<br>

   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.<br>

   <figure><img src="https://1820663065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlibkdeN79Y0EFrnLB1c%2Fuploads%2FMG6941oeF8GjSkF8yr5g%2Ftelegram-cloud-document-2-5364177530070802228.jpg?alt=media&amp;token=8e4a021c-27d4-4ca3-abc3-1434401b1b58" alt=""><figcaption></figcaption></figure>
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.<br>

   <figure><img src="https://1820663065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlibkdeN79Y0EFrnLB1c%2Fuploads%2Fq6cUagD1Z66fc6XjPGZD%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-10-15%20%D0%B2%2013.58.10.png?alt=media&amp;token=2a346a20-a306-43c1-abfb-a62179d8d7a3" alt=""><figcaption></figcaption></figure>
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.<br>

   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.<br>

   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.<br>

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

   <figure><img src="https://1820663065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlibkdeN79Y0EFrnLB1c%2Fuploads%2FIz9CkIEVKNWDvFQDTXDO%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-10-15%20%D0%B2%2013.59.41.png?alt=media&amp;token=68da6080-1ba2-40da-b4b0-a40a87584533" alt=""><figcaption></figcaption></figure>
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](https://support.trybit.com/pt-br/integration/methods.md) seção). Depois de concluir a integração, você precisa testar o recebimento de POSTBACK (veja a [Testando sua Integração](https://support.trybit.com/pt-br/integration/testing.md) seção). Você só pode enviar uma solicitação para sair do modo de teste depois de testar com sucesso a sua integração.<br>

   <figure><img src="https://1820663065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlibkdeN79Y0EFrnLB1c%2Fuploads%2FpQZOX0ARJEcm18e4c3hV%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-10-15%20%D0%B2%2014.11.38.png?alt=media&amp;token=d4da5a83-a894-439c-ac10-5847a0d5d295" alt=""><figcaption></figcaption></figure>
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](https://support.trybit.com/pt-br/general-information/connection-requirements.md) 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.<br>

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

   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.<br>

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

   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.<br>

   <figure><img src="https://1820663065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlibkdeN79Y0EFrnLB1c%2Fuploads%2FJ6udj3VFf1dg9AHZn5eR%2Ftelegram-cloud-document-2-5370997719093521431.jpg?alt=media&amp;token=4c4c71d3-ac90-437a-b9e8-03d8d3af305f" alt=""><figcaption></figcaption></figure>
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.<br>

   <figure><img src="https://1820663065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlibkdeN79Y0EFrnLB1c%2Fuploads%2FHMAqU702KyPrCvKinUXM%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-10-15%20%D0%B2%2014.17.45.png?alt=media&amp;token=7f57c6fb-5f86-46a1-861e-488abb92b502" alt=""><figcaption></figcaption></figure>
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](https://support.trybit.com/pt-br/integration/testing.md) 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](https://support.trybit.com/pt-br/general-information/connection-requirements.md) 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

{% hint style="info" %}
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.
{% endhint %}

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.<br>

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

   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.<br>

   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.<br>

   <figure><img src="https://1820663065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlibkdeN79Y0EFrnLB1c%2Fuploads%2FvbWYspxbyfdb79VjxrvZ%2Ftelegram-cloud-document-2-5370997719093521432.jpg?alt=media&amp;token=9f8277f5-99e4-4761-a0cd-27ba395e3bd4" alt=""><figcaption></figcaption></figure>
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.

<figure><img src="https://1820663065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlibkdeN79Y0EFrnLB1c%2Fuploads%2FZsHDc6QpB1uiLc4ZXkI9%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-10-15%20%D0%B2%2014.23.42.png?alt=media&amp;token=ddabfaec-0f9d-47c3-b453-69a78f23561b" alt=""><figcaption></figcaption></figure>

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.

{% hint style="success" %}
Se você tiver alguma dúvida ou precisar de ajuda, você pode entrar em contato com nosso suporte via chat no site e na sua conta pessoal, além de nos chamar no Telegram. Os contatos de suporte estão listados [em nosso site](https://trybit.com/support).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://support.trybit.com/pt-br/getting-started/add-project.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
