iPayWebhooks & intégrations
Notifications en temps réel sur vos événements (paiement réussi, échoué, déclaré). Webhooks configurables par produit pour connecter votre système.
- ✓Webhooks par événement
- ✓Historique des appels et payloads
- ✓Retry automatique
- ✓URL différentes par produit
Événements webhook détaillés
Chaque événement est envoyé en POST JSON vers l'URL configurée sur votre produit. Voici ce que iPay envoie et pourquoi.
transaction.completedPourquoi il est envoyé
Le paiement a été reçu et confirmé. Votre produit peut débloquer l'accès, générer la facture finale, envoyer une confirmation au client, ou synchroniser vos stocks.
Quand : Client déclare un virement bancaire, déclare un mandat postal, ou mise à jour manuelle du statut vers « payé » dans le dashboard. Aussi envoyé lorsque le callback de la passerelle (ClicToPay, Flouci, SMS) confirme le paiement.
Payload : id, status, product_id, customer_id, month, amount, currency, invoice_reference
transaction.createdPourquoi il est envoyé
Une nouvelle transaction a été générée pour un abonnement. Le cycle de facturation démarre — votre produit peut préparer l'envoi du lien de paiement au client ou notifier le service concerné.
Quand : Génération automatique ou manuelle d'un paiement depuis un abonnement actif (prélèvement récurrent). Déclenché à chaque nouvelle échéance créée.
Payload : id, status, product_id, customer_id, month, amount, currency, invoice_reference
transaction.failedPourquoi il est envoyé
Le paiement a échoué ou a été refusé. Votre produit peut relancer le client, proposer un autre moyen de paiement ou mettre à jour le statut du dossier.
Quand : Retour d'échec de la passerelle (ClicToPay, Flouci, SMS) ou expiration du délai de paiement. Envoyé vers l'URL webhook « échec » configurée sur le produit.
Payload : id, status, product_id, customer_id, month, amount, currency, invoice_reference