Chaque paiement confirmé, directement chez vous.
Dès qu’un paiement aboutit, GeniusPay appelle votre serveur avec l’événement signé. Vous vérifiez la signature, vous livrez la commande.
Recevoir un webhook en toute confiance
- 01
Indiquez votre URL
L’adresse de votre serveur qui recevra les événements.
- 02
Vérifiez la signature
HMAC-SHA256 de « timestamp.corps », dans X-Webhook-Signature.
- 03
Traitez l’événement
payment.success : la commande est payée, vous la livrez.
Vérifier une signature, en dix lignes
Calculez l’empreinte HMAC-SHA256 du timestamp et du corps brut avec votre secret, comparez-la en temps constant à l’en-tête reçu. Si elles diffèrent, refusez l’appel.
import crypto from 'node:crypto'; app.post('/webhooks/geniuspay', express.raw({ type: 'application/json' }), (req, res) => { const timestamp = req.header('X-Webhook-Timestamp'); const signature = req.header('X-Webhook-Signature') ?? ''; const expected = crypto .createHmac('sha256', process.env.GENIUSPAY_WEBHOOK_SECRET) .update(`${timestamp}.${req.body}`) .digest('hex'); const valid = signature.length === expected.length && crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected)); if (!valid) return res.sendStatus(401); const event = JSON.parse(req.body); if (event.event === 'payment.success') { // Commande event.data.metadata.order_id payée } res.sendStatus(200);});Relances automatiques
Votre serveur ne répond pas ? L’événement est renvoyé.
Identifiant de livraison
Chaque envoi est identifié pour ignorer les doublons.
Inspecteur temps réel
Suivez chaque événement envoyé depuis le dashboard.