Configuration des webhooks
Emplacement : Paramètres → Paiements → Webhook
Emplacement :Paramètres → Paiements → Webhook
Les webhooks permettent à QuantaPay de notifier votre serveur en temps réel lorsqu'un paiement est effectué.
Champs
| Champ | Description |
|---|---|
| URL du webhook | Le point de terminaison HTTPS sur votre serveur qui recevra les requêtes POST lorsque des événements de paiement se produisent. Doit être une URL accessible au public. |
| Clé secrète du webhook | Secret auto-généré inclus dans la charge utile JSON du webhook en tant que champkey. Utilisez ceci pour vérifier que les webhooks entrants proviennent bien de QuantaPay. |
Configuration
- Entrez l'URL de votre point de terminaison webhook (par exemple,
https://yoursite.com/webhook/quantapay) - LaClé secrète du webhookest générée automatiquement. Cliquez sur le bouton d'actualisation pour la régénérer si nécessaire.
- Enregistrez les paramètres.
Comment ça marche
Lorsqu'un paiement est effectué (statutC), QuantaPay envoie une requête HTTP POST à votre URL de webhook avec :
- Un corps JSON contenant
{ "key": "your-secret", "transaction": { ... } } - Vérifiez que le champ
keycorrespond à votre clé secrète de webhook pour confirmer l'authenticité.
Pour le format complet de la charge utile du webhook, le code de vérification de la signature et les meilleures pratiques, consultezRéférence API : Webhooks.
Tests
Pour tester votre webhook :
- Créez une session de paiement test via l'API
- Effectuez un petit paiement
- Vérifiez les journaux de votre serveur pour le webhook entrant
Astuce: Utilisez un service commewebhook.sitependant le développement pour inspecter les charges utiles des webhooks entrants.