# その瞬間を、 決済が確定する 。

> Stripe の決済、失敗した請求、サブスクリプションのイベントをプッシュ通知で受け取れます。Stripe や Paddle に Webhook を追加するだけで、売上や解約の動きをスマホで確認できます。

<!-- source: https://pocketalert.app/ja/use-cases/payment-alerts -->

最終更新日:2026-10-25

Pocket Alert は Stripe の Webhook を、スマホに届くプッシュ通知に変換します。成功した決済、決済の失敗、解約のすべてが 1 秒未満で、金額と顧客情報付きで届きます。顧客から連絡が来る前に、決済の失敗を把握できます。

## 決済アラートまでの 3 ステップ

1. **Webhook を作成** — Stripe のペイロードを割り当てる GJSON テンプレートを使って Pocket Alert の Webhook を作成し、受信 URL をコピーします。
2. **Stripe のエンドポイントを追加** — 受信 URL を Stripe のエンドポイントに貼り付け、charge.succeeded、charge.failed など必要なイベントを選択します。
3. **売上を確認** — テスト決済を行います。金額と顧客のメールアドレス付きの通知がスマホに届きます。

## 売上をリアルタイムで把握

決済サービスが Webhook を送信すると、すべての売上、決済失敗、解約がすぐにスマホに届きます。

- **あらゆる決済サービスに対応** — Stripe、PayPal、Paddle、LemonSqueezy のエンドポイントに Webhook URL を追加するだけで、売上の通知が届き始めます。
- **金額と顧客情報** — 金額、顧客のメールアドレス、イベントの種類を割り当てると、実際の売上を表す通知になります。
- **イベントを選択** — 必要なイベントだけを選択できます。決済の成功、決済の失敗、解約などから選べます。
- **決済失敗と解約を把握** — charge.failed 用と customer.subscription.deleted 用に Webhook を作成すると、督促と解約をそれぞれ別のチャンネルで通知できます。
- **リアルタイムの売上把握** — 売上が確定するとすぐに届きます。ダッシュボードを更新する必要も、日次レポートを待つ必要もありません。
- **直接連携と安全性** — 各 Webhook URL は専用で、HTTPS で秘密に保たれます。そのため、Stripe から直接指定できます。

## Stripe を接続

### 1. Pocket Alert の Webhook を作成

名前と、Stripe のペイロードのフィールドを割り当てる GJSON の `message` テンプレートを定義します。これにより受信 URL が発行されます。

```
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Stripe Payments","application_id":"qm47b9pzxzxg","message":"Payment %data.object.amount% %data.object.currency% from %data.object.billing_details.email%"}'
```

レスポンスには slug が含まれ、受信 URL は `https://p4a.me/wh/1234abcd` になります。[Webhooks](https://pocketalert.app/ja/webhooks) ページからも作成できます。

### 2. 受信 URL を Stripe に登録

Stripe ダッシュボードで Workbench を開き、Webhooks タブを選択して、イベントの送信先を作成をクリックします。ペイロードのスタイルには Snapshot を選んでください。thin イベントはオブジェクト ID だけを含み、テンプレートが空になるためです。次に `charge.succeeded`、`charge.failed`、`customer.subscription.deleted` などのイベントを選択し、Pocket Alert の受信 URL をエンドポイント URL に貼り付けます。

### 3. フィールドを割り当てる

Stripe はイベントの JSON を受信 URL に POST します。テンプレートはそのデータに対して展開されます。`%data.object.amount%`（最小通貨単位、たとえばセント）、`%data.object.currency%`、`%data.object.billing_details.email%` が利用できます。イベントの種類を示すには `%type%` を使います。GJSON のパスの詳細は[ドキュメント](https://info.pocketalert.app/api/webhooks/settings.html)をご覧ください。

## よくある質問

### 決済の通知はどのように受け取れますか？

Pocket Alert でメッセージテンプレートを設定した Webhook を作成し、その受信 URL を Stripe のエンドポイントとして登録してください。Stripe の各イベント（charge.succeeded、charge.failed、customer.subscription.deleted）がテンプレートに従って展開され、プッシュ通知として届きます。

### 金額と顧客情報を表示できますか？

はい。GJSON テンプレートで Stripe のペイロードから直接フィールドを取得できます。たとえば %data.object.amount% や %data.object.billing_details.email% を使うと、通知は「New payment 4900 · alex@acme.com」のように表示されます。Stripe の金額は最小通貨単位（セント）で表されます。

### 受け取るイベントを選べますか？

Stripe のエンドポイントで、必要なイベント（charge.succeeded、charge.failed、customer.subscription.deleted など）を選択してください。選択したイベントのみが受信 URL に POST され、スマホに届きます。

### どの決済サービスに対応していますか？

Stripe、PayPal、Paddle、LemonSqueezy、Chargebee など、Webhook を送信する決済サービスであれば利用できます。エンドポイントに Pocket Alert の受信 URL を指定し、テンプレートでペイロードのフィールドを割り当ててください。

### 決済失敗と売上の通知を分けられますか？

はい。イベントの種類ごとに Pocket Alert の Webhook を作成できます。たとえば charge.failed 用と customer.subscription.deleted 用にそれぞれ作成し、別々のアプリケーションに割り当てると、督促と解約の通知を区別して受け取れます。

### 決済失敗の通知だけ、通常の売上より大きく知らせられますか？

Webhook ごとに通知レベルを設定できます。通常の売上は標準のままにし、charge.failed の Webhook は高に設定すると、iPhone の集中モードでも通知が届きます。解約イベントは記録用としてサイレントにすることもできます。Android では、緊急レベルに設定するとおやすみモードでも通知されます。本番アカウントの決済が失敗してサービスが止まった場合などに役立ちます。
