> For the complete documentation index, see [llms.txt](https://docs.trybit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.trybit.com/pt/start/test-integration.md). # Testes de integração Antes de aceitar pagamentos reais, a integração tem de ser testada de ponta a ponta: a fatura é criada da mesma forma que um cliente a criaria, e a notificação de pagamento chega ao seu servidor e é processada corretamente. Para este fim, cada novo projeto tem um modo de teste. ### O que é o modo de teste O modo de teste é ativado automaticamente depois de um projeto ser adicionado e mantém-se ativo até que o pedido para sair dele seja aprovado. O estado atual é mostrado no cabeçalho da página do projeto — o interruptor "Modo de teste". * As faturas podem ser criadas por qualquer método e confirmadas sem pagamento real. * As faturas de teste não afetam o saldo — os fundos não são creditados. * As definições na secção "Integração e API" só podem ser alteradas no modo de teste. * As secções "Conversão automática", "Carteiras estáticas", "Definições de POS", "Construtor de página de pagamento" e "Widget de pagamento" ficam disponíveis depois de o pedido ser aprovado. ### Como testar a integração 1. **Crie uma fatura como cliente.** Faça uma encomenda no seu site ou no seu bot — da mesma forma que os clientes reais farão. Uma fatura criada manualmente na secção "Pagamentos" não testa a integração. 2. **Abra faturas de teste.** Na secção "Pagamentos", mude para "Teste" e abra a fatura criada. 3. **Confirme a fatura sem pagamento.** Clique em "Confirmar fatura sem pagamento". 4. **Verifique a notificação.** A Trybit enviará um POSTBACK para o URL de notificação, e o estado da fatura mudará para "Pago". Certifique-se de que o seu sistema recebeu a notificação, verificou a assinatura e atualizou o estado da encomenda. Para os métodos "API", "Módulos CMS" e "Widget HTML (com postback)", uma verificação de POSTBACK bem-sucedida é obrigatória — sem ela, o pedido para sair do modo de teste não pode ser submetido. Para "Widget HTML (sem postback)", não é necessária qualquer verificação. ### O que fazer se o estado da fatura não mudar * Verifique se o URL de notificação está correto e acessível externamente na porta 443 ou 80. * Certifique-se de que o formato do POSTBACK (JSON ou form-data) corresponde ao que o seu processador espera. * Verifique a hora do servidor: o JWT é válido durante 5 minutos; se o relógio estiver dessincronizado, a assinatura é considerada inválida. * Certifique-se de que a assinatura é verificada com a CHAVE SECRETA deste projeto específico. O resultado da entrega de cada notificação — o pedido e a resposta do seu servidor — é mostrado na secção "Histórico de postback". Depois de fazer correções, a notificação pode ser reenviada. A secção encontra-se na página da fatura paga: "Pagamentos" → a fatura relevante. ### O que verificar antes de submeter o pedido * A fatura é criada ao fazer uma encomenda na sua plataforma. * O POSTBACK é entregue, a assinatura é verificada e o estado da encomenda é atualizado. * Os URLs de pagamento de sucesso e de falha conduzem às páginas corretas. * Os detalhes do projeto cumprem [os requisitos e restrições](https://support.trybit.com/general-information/connection-requirements). ### Como sair do modo de teste O pedido é submetido na etapa "Rever e submeter" do processo de adição do projeto. A revisão demora até 24 horas a partir da submissão; o estado do pedido é mostrado no painel. Uma vez aprovado, receberá uma notificação por email. Se o pedido for rejeitado, o motivo será indicado — dependendo dele, pode fazer alterações e voltar a submeter o pedido. ### O que muda depois de sair do modo de teste * O botão "Confirmar fatura sem pagamento" deixa de funcionar: uma fatura é confirmada com o pagamento total ou manualmente — se concordar em aceitar um montante parcialmente recebido. * Os depósitos são creditados no saldo. * As secções "Conversão automática", "Carteiras estáticas", "Definições de POS", "Construtor de página de pagamento" e "Widget de pagamento" ficam disponíveis. * A secção "Integração e API", bem como o nome do projeto, o tipo de negócio e a descrição, ficam bloqueados para edição. ### Como reativar o modo de teste Ative o interruptor "Modo de teste" no cabeçalho do projeto. Isto é necessário, por exemplo, para alterar as definições na secção "Integração e API". Depois das alterações, o projeto é enviado novamente para revisão — demora até 24 horas, e a aceitação de pagamentos reais fica suspensa durante esse período. {% hint style="success" %} Se tiver alguma questão ou precisar de assistência, contacte o nosso chat de apoio no site e no painel, ou contacte-nos no Telegram. Os contactos de suporte estão listados no 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://docs.trybit.com/pt/start/test-integration.md?ask=&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.