新しいサブスクリプション(トリガー)
このピースでできること
- Stripeで新しいサブスクリプションが作成されたことを検知したら、ワークフローを開始します。
Stripe の接続方法
Stripe のシークレット API キーを入力して接続します。
シークレット API キーの取得手順
- Stripe ダッシュボード にログインします
- 左メニューの 開発者(Developers) をクリックします
- 「API キー(API keys)」 を開きます
- 「シークレットキー(Secret key)」 の 「表示(Reveal live key)」 をクリックします
- 表示されたシークレットキー( または テスト用 )をコピーします
- 接続画面の 「Secret API Key」 欄に貼り付けます
本番環境では から始まるキーを使用してください。テスト目的の場合は から始まるキーを使用できます。
ピースの設定項目
- 設定項目はありません。
取得できる情報
Stripeの 通知から、作成されたサブスクリプションの情報を取得できます。
| 実際のキー | 内容・条件 |
|---|---|
| / | 対象データのIDと種類。イベント全体のIDではありません。 |
| 対象データの作成日時(Unixタイムスタンプ)。 | |
| Stripe側で設定した追加情報。未設定の場合は空です。 | |
| / | 契約の顧客ID・状態。作成時点で有効かどうかはstatusで確認します。 |
| 契約明細の配列。各要素の ・・ などを参照します。 | |
| / | 最新請求書のIDなど・期間末に解約する設定。 |
| / | 試用期間の日時。試用期間がない場合はnullなどになります。 |
- 出力はWebhook内の そのものです。後続ステップでは などを直接参照します。イベント全体の という階層にはなりません。
- 項目の有無やnull、関連IDと展開済みオブジェクトの違いはStripeのAPI版・通知内容・設定によって異なります。
- テストでは既存サブスクリプションを最大5件取得します。
出力例(抜粋)
キーの使い方を示す架空例です。実際の値や全項目を示すものではありません。