売上をリアルタイムで把握
決済サービスが Webhook を送信すると、すべての売上、決済失敗、解約がすぐにスマホに届きます。
あらゆる決済サービスに対応
Stripe、PayPal、Paddle、LemonSqueezy のエンドポイントに Webhook URL を追加するだけで、売上の通知が届き始めます。
金額と顧客情報
金額、顧客のメールアドレス、イベントの種類を割り当てると、実際の売上を表す通知になります。
イベントを選択
必要なイベントだけを選択できます。決済の成功、決済の失敗、解約などから選べます。
決済失敗と解約を把握
charge.failed 用と customer.subscription.deleted 用に Webhook を作成すると、督促と解約をそれぞれ別のチャンネルで通知できます。
リアルタイムの売上把握
売上が確定するとすぐに届きます。ダッシュボードを更新する必要も、日次レポートを待つ必要もありません。
直接連携と安全性
各 Webhook URL は専用で、HTTPS で秘密に保たれます。そのため、Stripe から直接指定できます。
決済アラートまでの 3 ステップ
Webhook を作成
Stripe のペイロードを割り当てる GJSON テンプレートを使って Pocket Alert の Webhook を作成し、受信 URL をコピーします。
Stripe のエンドポイントを追加
受信 URL を Stripe のエンドポイントに貼り付け、charge.succeeded、charge.failed など必要なイベントを選択します。
売上を確認
テスト決済を行います。金額と顧客のメールアドレス付きの通知がスマホに届きます。
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 ページからも作成できます。
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 のパスの詳細はドキュメントをご覧ください。
よくある質問
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 · [email protected]」のように表示されます。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 では、緊急レベルに設定するとおやすみモードでも通知されます。本番アカウントの決済が失敗してサービスが止まった場合などに役立ちます。