# Webhooks : campagnes, scans, écrans et paiements

> Recevez un POST sur votre URL quand une campagne démarre ou s’arrête, qu’un QR code est scanné, qu’un écran se déconnecte ou qu’un paiement part.

Source: https://verse.ad/fr/docs/webhooks

Docs

Construire avec VERSE.

Appairez des écrans, planifiez et achetez des campagnes depuis vos propres outils, suivez ce qui se passe après un scan et enchérissez depuis votre DSP.

[Lieux Appairer un écran Six chiffres ou un scan de QR code.](http://127.0.0.1:3399/fr/docs/appairer-un-ecran#reference)[Marques Planifier par API Prévoir, lancer et suivre depuis vos outils.](http://127.0.0.1:3399/fr/docs/api-rest#reference)[Agents Connecter le serveur MCP Planifier et piloter avec un agent IA.](http://127.0.0.1:3399/fr/docs/serveur-mcp#reference)[Partenaires Enchérir depuis votre DSP OpenRTB 2.6, PMP et PG.](http://127.0.0.1:3399/fr/docs/openrtb#reference)

Plateforme

## Webhooks

Recevez un POST sur votre URL dès qu’un changement survient, au lieu d’interroger l’API en boucle.

ÉvénementEnvoyé quand

campaign.liveUne campagne est validée et commence à diffuser

campaign.pausedUne campagne est mise en pause par une personne, l’Agent ou l’API

scan.createdQuelqu’un scanne un QR code sur l’une de vos pubs

screen.offlineUn écran d’un lieu est hors ligne depuis 10 minutes

payout.sentUn retrait d’un lieu quitte VERSE

```
{
  "type": "scan.created",
  "created": "2026-11-26T09:41:12Z",
  "data": { "scanId": "sc_7Hq2", "campaignId": "c_pave", "screen": "Brew Lab · Counter",
            "venueType": "cafe", "weather": "rainy" }
}
```

Exemples à titre indicatif.

- Chaque requête porte un en-tête Verse-Signature : un HMAC-SHA256 du corps avec le secret de votre endpoint.
- Les livraisons échouées sont relancées, avec un délai croissant, pendant 24 heures.

[← Précédent: OpenRTB](http://127.0.0.1:3399/fr/docs/openrtb#reference)