Joltでは、Stripeと連携することで売上データを自動でJoltに取り込むことが可能です。
概要
Stripe連携を行うと、以下の流れでデータが連携されます。
Stripeで決済完了 ↓ Stripe Webhookが送信される ↓ JoltがWebhookを受信 ↓ 取引レコードが自動作成される
事前準備
- Stripeアカウントを保有していること
Jolt側のStripe設定ページ
Joltの管理画面より以下にアクセスします。
プログラム設定 > 連携設定 > アプリ連携 > Stripe
「設定」ボタンをクリックすると、以下の情報が表示されます。
- Webhook受信用URL
- Endpoint Secret（Stripe側で取得して設定）
Webhook受信用URLをコピーしておきます。
設定手順
- Stripeにログイン
- Stripeのダッシュボードにログインします。
- Webhook設定画面へ移動
- 左下の「開発者」をクリックし、「Webhook」を選択します。
- 送信先を追加
- 「送信先を追加する」をクリックします。
- イベントのリッスン元を選択
- 「お客様のアカウント」を選択します
- イベントを選択
- 以下のイベントにチェックを入れます
- Charge > charge.refunded
- Payment Intent > payment_intent.succeeded
- 送信先タイプを選択
- 「Webhookエンドポイント」を選択し、「続行」をクリックします。
- Webhookエンドポイントを設定
- 以下の内容を入力します
- 送信先名：任意（例：Jolt連携）
- 説明：任意
- エンドポイントURL：Joltの「Webhook受信用URL」を貼り付け
- 入力後、「送信先を作成」をクリック
- 署名シークレットを取得
- 作成したWebhook設定を開き、署名シークレット（Signing Secret） をコピーします
- Jolt側に設定
- JoltのStripe連携設定画面に戻り、Endpoint Secret に、Stripeでコピーした値を貼り付けます
- 接続を有効化
- 「接続ステータス」をONにし、保存します。
- Stripeの顧客IDをコピーする
- Stripeの顧客IDを
- Stripe連携設定の接続を有効化すると、顧客ページの追加情報に「Stripe顧客ID」が追加されます。そこにコピーしたStripeの顧客IDを入力します。
キャンセル（返金）が発生した際の挙動
Stripeで返金処理が行われると、自動的にJoltへ通知（Webhook）が送信され、取引データが更新されます。
返金時の挙動は、以下の2パターンで異なります。
- 全額返金の場合
Stripeで決済金額の全額が返金された場合、以下の処理が行われます。
- 該当の取引レコードが削除される
- その取引に紐づく報酬の実績データも削除される
その決済による紹介報酬は「無効（なかった扱い）」になります
- 一部返金の場合
一部のみ返金された場合（例：10,000円 → 3,000円返金）、以下のように処理されます。
- 元の取引データ・リワード実績が一度削除される
- 返金後の金額で、取引データが新しく作成される（例の場合、7,000円の取引として再作成）
紹介報酬は「返金後の金額」をベースに再計算されます