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

# Bonnes pratiques

> Les règles à suivre pour une intégration fiable et sécurisée.

## Identifiants de commande

* Créez un `transaction_id` unique par commande, et conservez-le dans votre base.
* Ne réutilisez jamais un identifiant : l'API le refuse avec une erreur `409`.

## Confirmer les paiements

* Marquez une commande payée uniquement après le webhook `transaction.successful` ou un statut `successful`.
* Gérez les doublons : un même événement peut être reçu plus d'une fois.

## Sécurité

* Gardez votre clé API et le secret du webhook sur votre serveur, jamais dans le navigateur.
* Vérifiez la signature de chaque webhook, avec le corps brut.
* Révoquez immédiatement une clé exposée.

## Tests

* Intégrez-vous d'abord avec une clé `fp_test_`.
* Testez les cas d'échec : montant trop bas, identifiant déjà utilisé, clé révoquée.
* Passez en production seulement quand le parcours complet fonctionne.


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