> 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/integration/postback.md).

# Notificações de Pagamento (POSTBACK)

POSTBACK: configuração, verificação de autenticidade e histórico de notificações do status do pagamento.

**POSTBACK** é uma notificação que a Trybit envia para a URL especificada pelo comerciante (URL de notificação / URL de callback) sempre que o status de uma fatura muda. Esta é a principal forma de saber automaticamente sobre um pagamento, sem consultar a API manualmente.

### Como configurá-lo

A URL de notificação é especificada nas configurações de integração do projeto — no campo "URL de notificação" (disponível apenas no modo de teste, veja [Configurações do projeto](/pt-br/getting-started/configuracoes-do-projeto.md)).

<figure><img src="https://1820663065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlibkdeN79Y0EFrnLB1c%2Fuploads%2Fezhcfte47NgS6EHpQIjz%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%2015.41.19.png?alt=media&amp;token=6eb81792-f25e-4805-9b74-07f3871824de" alt=""><figcaption></figcaption></figure>

### Como funciona

1. Uma fatura é criada — manualmente, via API ou por qualquer outro método de integração.
2. O cliente paga a fatura.
3. A Trybit envia um POSTBACK para a URL de notificação do projeto — com os dados da fatura: status, número da fatura (INV), valor do pagamento e moeda, e o seu order\_id interno (se ele tiver sido informado ao criar a fatura).
4. Além disso, o status da fatura pode ser verificado a qualquer momento via API pelo número da fatura (INV) — o método de informações da fatura permite solicitar até 100 faturas em uma única chamada.

### Como verificar a autenticidade de uma notificação

Todo POSTBACK contém um token assinado (JWT, algoritmo HS256) válido por **5 minutos** a partir do momento em que é enviado. Do lado do comerciante, você precisa verificar esse token usando a chave secreta do seu projeto — isso confirma que a notificação realmente veio da Trybit e não foi falsificada.

Uma causa comum de problemas relacionados a webhook é uma diferença de horário no servidor do comerciante: se o relógio do servidor estiver adiantado ou atrasado em mais de alguns minutos, o token fica fora da janela de 5 minutos e é considerado inválido. Isso é a primeira coisa a verificar ao diagnosticar postbacks ausentes.

### Histórico de POSTBACK

Seu painel pessoal tem uma seção "Histórico de Postback" — aqui você pode ver se um postback foi entregue com sucesso e reenviá-lo, se necessário (inclusive para faturas que foram pagas durante o modo de teste, mesmo depois de sair dele).

<figure><img src="https://1820663065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlibkdeN79Y0EFrnLB1c%2Fuploads%2FWVOqQtyDEQFEVx694w3e%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%2015.53.45.png?alt=media&amp;token=fe9cd851-4bce-4716-a739-1444400fe35f" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Se você tiver alguma dúvida ou precisar de ajuda, você pode contatar nosso suporte via chat no site e na sua conta pessoal, além de falar conosco no Telegram. Os contatos 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://support.trybit.com/pt-br/integration/postback.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.