支払いに失敗しました（トリガー）
このピースでできること
- Stripeで支払いが失敗したことを検知したら、ワークフローを開始します。
Stripe の接続方法
Stripe のシークレット API キーを入力して接続します。
シークレット API キーの取得手順
- Stripe ダッシュボード にログインします
- 左メニューの 開発者（Developers） をクリックします
- 「API キー（API keys）」 を開きます
- 「シークレットキー（Secret key）」 の 「表示（Reveal live key）」 をクリックします
- 表示されたシークレットキー（ または テスト用 ）をコピーします
- 接続画面の 「Secret API Key」 欄に貼り付けます
本番環境では から始まるキーを使用してください。テスト目的の場合は から始まるキーを使用できます。
ピースの設定項目
- 設定項目はありません。
取得できる情報
Stripeの 通知から、失敗したチャージ（Charge）の情報を取得できます。
| 実際のキー | 内容・条件 |
|---|---|
| / | 対象データのIDと種類。イベント全体のIDではありません。 |
| 対象データの作成日時（Unixタイムスタンプ）。 | |
| Stripe側で設定した追加情報。未設定の場合は空です。 | |
| / | 金額と通貨。金額の単位は通貨の最小単位です。 |
| / | 関連する顧客ID・PaymentIntent ID。未設定の場合はnullなどになります。 |
| / | チャージの状態と支払い済みかどうか。 |
| / | 失敗コード・説明。通知に含まれる場合に利用できます。 |
- 出力はWebhook内の そのものです。後続ステップでは などを直接参照します。イベント全体の という階層にはなりません。
- 項目の有無やnull、関連IDと展開済みオブジェクトの違いはStripeのAPI版・通知内容・設定によって異なります。
- テストでは失敗したChargeを最大5件検索します。
出力例（抜粋）
キーの使い方を示す架空例です。実際の値や全項目を示すものではありません。