New Dispute(トリガー)
このピースでできること
- Stripeで異議申し立て(Dispute)が発生したことを検知したら、ワークフローを開始します。
- チャージIDやPayment Intent IDで絞り込めます。
Stripe の接続方法
Stripe のシークレット API キーを入力して接続します。
シークレット API キーの取得手順
- Stripe ダッシュボード にログインします
- 左メニューの 開発者(Developers) をクリックします
- 「API キー(API keys)」 を開きます
- 「シークレットキー(Secret key)」 の 「表示(Reveal live key)」 をクリックします
- 表示されたシークレットキー( または テスト用 )をコピーします
- 接続画面の 「Secret API Key」 欄に貼り付けます
本番環境では から始まるキーを使用してください。テスト目的の場合は から始まるキーを使用できます。
ピースの設定項目
1. 請求ID(任意)
- 特定のチャージ(ch_...)に対する異議申し立てだけを対象にしたい場合に入力します。
2. 支払い意図ID(任意)
- 特定のPayment Intent(pi_...)に対する異議申し立てだけを対象にしたい場合に入力します。
取得できる情報
Stripeで異議申し立て(Dispute)が作成された際、 のWebhook通知に含まれる異議申し立てオブジェクト()1件を後続ステップに渡します。
| 実際のキー | 内容・条件 |
|---|---|
| / | 異議申し立てID、オブジェクト種別() |
| / | 対象のチャージID、Payment Intent ID。設定した請求ID・支払い意図IDと一致しない通知は出力しません |
| / | 異議申し立ての理由、状態 |
| / / | 金額、通貨、作成時刻( はUnixタイムスタンプ) |
| 証拠提出期限。実際の値や有無は異議申し立てによって異なります |
- 通常実行:Webhookのを返します。条件に一致しない場合は出力しません。
- テスト:Stripe APIのから最大5件を取得します。通常実行と異なり、入力した請求ID・支払い意図IDによる絞り込みはテストには適用されません。実際の出力項目は、接続先のデータやイベントにより異なります。
出力例(抜粋)
後続ステップで参照するキーの説明用の架空例です。実際の値ではありません。