Retour
Webhooks

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

  1. 01

    Indiquez votre URL

    L’adresse de votre serveur qui recevra les événements.

  2. 02

    Vérifiez la signature

    HMAC-SHA256 de « timestamp.corps », dans X-Webhook-Signature.

  3. 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.

webhooks/geniuspay
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.

Obtenir ma clé API