Get Started
Evènements et webhook
Gérer les évènements du Checkout Stan
Les évènements du Checkout Stan est un moyen d’échanger des informations avec votre serveur lorsqu’un client procède au Checkout Stan. Un évènement consiste en un appel de votre URL de webhook :
POST https://votre-webhook.fr/stan/event
Content-Type: application/json
X-HMAC-Signature: <signature HMAC>
X-Stan-SessID: <session id lors de la création du checkout>
Corps d’une requête d’évènement
Tous les évènements ont une structure de base qui comporte un champs variable selon l’évènement. La structure de base est la suivante :
Corps JSON d'une requête d'évènement
{
"event_type": "string", // type d'évènement
"payload": "object|undefined" // informations relatives à l'évènement
}
Signature HMAC
Tous les évènements sont signés avec HMAC, la signature est incluse dans l’en-tête HTTP X-HMAC-Signature
. Utilisez cette signature pour vérifier que l’évènement a bien été envoyé par les services de Stan. La clé secrète pour générer la signature est la secret_key
de vos identifiants API. Voici quelques exemples pour vérifier la signature d’un évènement :
Liste des évènements
Nom de l’évènement | Description |
---|---|
payment.created | Un paiement a été tenté. |
payment.status_changed | Le status d’un paiement relatif à un checkout a changé. |
customer.created | Un client a été créé. |
customer.shipping_address_changed | Le client a changé son adresse de livraison. |
customer.authenticated | Le client s’est authentifié. |
checkout.line_item_changed | Le client a modifié son panier. |
checkout.shipping_method_changed | Le client a choisi une méthode de livraison. |