> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flasshpay.my/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks et signature

> Recevez la confirmation de paiement sur votre serveur, et vérifiez sa signature.

Quand un paiement réussit, flasshpay envoie un message `POST` à l'adresse de votre webhook. Vérifiez toujours sa signature avant de traiter la commande.

## Événement

```json theme={null}
{
  "event": "transaction.successful",
  "created_at": "2026-11-19T10:00:05.000Z",
  "data": {
    "transaction_id": "commande-1042",
    "status": "successful",
    "amount": 5000,
    "currency_code": "XAF",
    "country_code": "CM",
    "payment_method": "MTN",
    "environment": "test"
  }
}
```

## En-têtes

| En-tête | Contenu |
| - | - |
| `X-FlashPay-Timestamp` | Horodatage Unix de l'envoi |
| `X-FlashPay-Signature` | HMAC-SHA256 en hexadécimal |

La signature est calculée sur `timestamp.corps`, avec le secret de votre webhook. Le corps est celui exactement reçu, avant tout traitement.

## Vérification

```javascript Node.js theme={null}
import crypto from "node:crypto";

export function verifyFlasshpay(rawBody, timestamp, signature, secret) {
  // Refuser les envois de plus de 5 minutes (protection contre le rejeu).
  if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;

  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${timestamp}.${rawBody}`)
    .digest("hex");

  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}
```

> [!WARNING]
>
> Utilisez le corps **brut** de la requête. Si votre framework le reformate avant la vérification, la signature ne correspondra plus.

## Réponse attendue

Répondez `200` rapidement, puis traitez la commande. flasshpay réessaie l'envoi en cas d'échec, à quelques intervalles espacés.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.