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

# Notifications de paiement (POSTBACK)

POSTBACK : configuration, vérification de l'authenticité et historique des notifications de statut de paiement.

**POSTBACK** est une notification que Trybit envoie à l’URL spécifiée par le commerçant (URL de notification / URL de rappel) chaque fois que le statut d’une facture change. C’est le principal moyen d’être informé automatiquement d’un paiement, sans interroger manuellement l’API.

### Comment le configurer

L’URL de notification est spécifiée dans les paramètres d’intégration du projet — dans le champ « URL de notification » (disponible uniquement en mode test, voir [Paramètres du projet](/fr/getting-started/parametres-du-projet.md)).

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

### Comment cela fonctionne

1. Une facture est créée — manuellement, via l’API ou via toute autre méthode d’intégration.
2. Le client paie la facture.
3. Trybit envoie un POSTBACK à l’URL de notification du projet — avec les données de la facture : statut, numéro de facture (INV), montant du paiement et devise, ainsi que votre order\_id interne (s’il a été transmis lors de la création de la facture).
4. De plus, le statut d’une facture peut être vérifié à tout moment via l’API à l’aide du numéro de facture (INV) — la méthode d’information sur la facture vous permet de demander jusqu’à 100 factures en un seul appel.

### Comment vérifier l’authenticité d’une notification

Chaque POSTBACK contient un jeton signé (JWT, algorithme HS256) valide pendant **5 minutes** à compter de son envoi. Du côté du commerçant, vous devez vérifier ce jeton à l’aide de la clé secrète de votre projet — cela confirme que la notification provient bien de Trybit et n’a pas été falsifiée.

Une cause fréquente des problèmes liés aux webhooks est un décalage horaire sur le serveur du commerçant : si l’horloge du serveur a un écart de plus de quelques minutes, le jeton se retrouve hors de la fenêtre de 5 minutes et est considéré comme invalide. C’est la première chose à vérifier lors du dépannage de postbacks manquants.

### Historique des POSTBACK

Votre tableau de bord personnel comporte une section « Historique des postbacks » — vous pouvez y voir si un postback a été livré avec succès, et le renvoyer si nécessaire (y compris pour les factures payées en mode test, même après en être sorti).

<figure><img src="https://2869212531-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 vous avez des questions ou besoin d’aide, vous pouvez contacter notre support via le chat sur le site web et dans votre espace personnel, ainsi que nous joindre sur Telegram. Les contacts du support sont indiqués [sur notre site 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/fr/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.