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

# Notificaciones de pago (POSTBACK)

POSTBACK: configuración, verificación de autenticidad e historial de notificaciones del estado del pago.

**POSTBACK** es una notificación que Trybit envía a la URL especificada por el comerciante (URL de notificación / URL de callback) cada vez que cambia el estado de una factura. Esta es la forma principal de enterarse de un pago automáticamente, sin consultar manualmente la API.

### Cómo configurarlo

La URL de notificación se especifica en la configuración de integración del proyecto — en el campo "Notification URL" (disponible solo en modo de prueba, véase [Configuración del proyecto](/es/getting-started/configuracion-del-proyecto.md)).

<figure><img src="https://546573016-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>

### Cómo funciona

1. Se crea una factura — manualmente, a través de la API o mediante cualquier otro método de integración.
2. El cliente paga la factura.
3. Trybit envía un POSTBACK a la URL de notificación del proyecto — con datos de la factura: estado, número de factura (INV), importe y moneda del pago, y tu order\_id interno (si se proporcionó al crear la factura).
4. Además, el estado de la factura puede comprobarse en cualquier momento a través de la API mediante el número de factura (INV) — el método de información de factura permite solicitar hasta 100 facturas en una sola llamada.

### Cómo verificar la autenticidad de una notificación

Cada POSTBACK contiene un token firmado (JWT, algoritmo HS256) válido durante **5 minutos** desde el momento en que se envía. Del lado del comerciante, debe verificar este token usando la clave secreta de su proyecto — esto confirma que la notificación realmente proviene de Trybit y no fue falsificada.

Una causa común de problemas relacionados con webhooks es una discrepancia de hora en el servidor del comerciante: si el reloj del servidor está desfasado más de unos minutos, el token queda fuera de la ventana de 5 minutos y se considera inválido. Esto es lo primero que debe comprobar al solucionar problemas de postbacks faltantes.

### Historial de POSTBACK

Su panel personal tiene una sección "Historial de Postbacks" — aquí puede ver si un postback se entregó correctamente y reenviarlo si es necesario (incluidas las facturas que se pagaron durante el modo de prueba, incluso después de salir de él).

<figure><img src="https://546573016-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" %}
Si tiene alguna pregunta o necesita ayuda, puede contactar con nuestro soporte mediante el chat en el sitio web y en su cuenta personal, así como comunicarse con nosotros en Telegram. Los datos de contacto del soporte figuran [en nuestro sitio web](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/es/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.