Identifiants de commande
- Créez un
transaction_idunique 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.successfulou un statutsuccessful. - 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.