Webhooks pour l'API Climate Orders

Stripe utilise des webhooks pour notifier votre application lorsqu’un événement se produit sur votre compte. Configurez un endpoint de webhook pour écouter la disponibilité des produits et les mises à jour de livraison.

Utiliser des événements de webhook de produit

climate.product.created

Stripe envoie cet événement lorsque Frontier ajoute un nouveau produit à l’inventaire des solutions d’élimination du carbone. Utilisez cet événement pour que votre application reste informée des derniers produits disponibles sur Frontier.

climate.product.pricing_updated

Stripe envoie cet événement lorsque le tarif d’un produit change. Dans ce cas, nous vous en informerons par e-mail deux semaines à l’avance, puis nous vous enverrons cet événement quand la modification prendra effet. Les tarifs des commandes déjà confirmées ne changeront jamais. Si nous mettons à jour la disponibilité d’un produit, nous vous en informons uniquement via cet événement.

Utiliser des événements de webhook de commande

Vous recevez un événement dès que l’état de votre commande change.

climate.order.delivered

Lorsque Frontier livre votre commande, Stripe envoie l’événement climate.order.delivered. Cet événement confirme que Frontier a bien reçu la solution d’élimination du carbone du fournisseur, vérifié la livraison et retiré les unités d’élimination du carbone en votre nom ou au nom du bénéficiaire désigné.

climate.order.delayed

Si Frontier n’est pas en mesure de traiter votre commande à la date de livraison prévue, Stripe envoie l’événement climate.order.delayed ainsi qu’un e-mail, au moins 60 jours avant la fin de l’année de livraison. L’événement inclut la nouvelle date de livraison attendue expected_delivery_year de la commande.

Vous pouvez décider d’accepter le report ou d’annuler la commande sous 30 jours pour recevoir un remboursement complet. Si aucune action n’est entreprise, nous tenterons de livrer les tonnes avant la nouvelle date de livraison expected_delivery_year prévue.

climate.order.product_substituted

Si vous commandez un produit auprès d’un fournisseur spécifique et que celui-ci n’est pas en mesure de respecter ses engagements, Frontier tente de remplacer le produit par un produit similaire d’un autre fournisseur du portefeuille Frontier. Stripe envoie l’événement climate.order.product_substituted, ainsi qu’un e-mail avec les détails du remplacement au moins 60 jours avant la fin de l’année de livraison. Si vous refusez le produit de remplacement, vous pouvez annuler la commande sous 30 jours pour recevoir un remboursement complet.

climate.order.canceled

Si Frontier n’est pas en mesure de traiter votre commande dans les 2 ans suivant la date de livraison initiale, vous recevrez un remboursement complet. Cette situation devrait rarement se présenter, car nous gérons activement le portefeuille afin de minimiser le risque lié à la livraison.

Frontier prend les décisions d’annulation au moins 60 jours avant la date de livraison prévue. Lorsqu’une commande est annulée, Stripe envoie un e-mail ainsi que l’événement climate.order.canceled.