Climate Orders API の Webhook
商品と注文の Webhook イベントについてご紹介します。
アカウントでイベントが発生すると、Stripe は Webhook を使用してアプリケーションに通知します。Webhook エンドポイントを設定して、商品の提供状況と達成状況をリッスンしてください。
商品の Webhook イベントを使用する
climate.product.created
Frontier が新しい商品を炭素除去インベントリーに追加すると、Stripe はこのイベントを送信します。Frontier が提供している最新の商品でアプリケーションを最新状態に保つために、このイベントを使用します。
climate.product.pricing_updated
Stripe は、プロダクトの価格が変更される場合に、このイベントを送信します。2 週間前にメールで通知し、価格が変更されたときにこのイベントを送信します。確定済みの注文の価格が変更されることはありません。プロダクトの提供状況を更新する場合は、このイベントでのみ通知します。
注文の Webhook イベントを使用する
注文のステータスが変更されるとイベントを受信します。
climate.order.delivered
Frontier が注文を達成すると、Stripe は climate.order.delivered イベントを送信します。このイベントは、Frontier がサプライヤーから炭素除去を受け取り、達成を確認して、お客様またはご指定の受取人の代わりに炭素除去単位を回収したことを確認します。
climate.order.delayed
Frontier が達成日までに注文のフルフィルメントを実行できない場合、Stripe は、達成年の年末より少なくとも 60 日前に climate.order.delayed イベントとメールを送信します。イベントには、注文の更新された expected_ が含まれています。
遅延を受け入れるか、30 日以内に注文をキャンセルして全額の返金を受け取るかはお客様が決定できます。ご対応がない場合、Stripe は更新後の expected_ までにその数量 (トン) を達成できるように取り組みを続けます。
climate.order.product_substituted
個々のサプライヤーに商品を注文して、そのサプライヤーが失敗した場合、Frontier は、その商品を Frontier ポートフォリオ内の別のサプライヤーによる同様の商品で代替できないか試みます。Stripe は、達成年の年末から 60 日以上前に、climate.order.product_substituted イベントと、代替の詳細が記載されたメールを送信します。代替を希望しない場合は、30 日以内に注文をキャンセルして、全額の返金を受け取ることができます。
climate.order.canceled
Frontier が元の達成予定日から 2 年以内に注文をフルフィルメントできない場合は、全額の返金を受け取ります。Stripe は達成に関するリスクを最小限に抑えるためにポートフォリオを積極的に管理しているため、これは稀な状況であると考えています。
Frontier は、注文の期日の 60 日以上前にキャンセルを決定します。注文がキャンセルされた場合、Stripe は、メールと climate.order.canceled イベントを送信します。