L'API Alma renvoie un webhook appelé "callback IPN" (pour Instant Payment Notification) lorsqu'un paiement a été accepté par Alma et son premier prélèvement effectué.
Ce webhook est indispensable pour les intégrations "redirect" où le client est redirigé vers une page de paiement herbergée par Alma, pour s'assurer que même s'il ferme la page de paiement juste avant de retourner sur votre site, la commande est tout de même validée.
Ce webhook est envoyé de manière asynchrone après le succès d'un paiement, et renvoyé jusqu'à 10 fois en cas de non-réponse de votre serveur ou de réponse autre que 200.
Le webhook n'est pas signé : il s'agit simplement d'un appel GET sur l'URL renseignée dans les données du paiement (ipn_callback_url), à laquelle est ajouté le paramètre pid=<ID du paiement>.
Afin de vérifier son authenticité, il vous suffit de rappeler l'API Alma avec votre clé privée pour récupérer les données complètes du paiement.
Pour une description détaillée, vous pouvez consulter le Guide d'intégration par API.