こんにちは😊
株式会社プロドウガの@YushiYamamotoです！
らくらくサイトの開発・運営を担当しながら、React.js・Next.js専門のフリーランスエンジニアとしても活動しています❗️

この記事は 決済を実装した体験談や決済関連（クレカ、QRコード、何でもOK！）の情報を投稿しよう！ by PAY Advent Calendar 2025 の参加記事です🎄

SaaSやサブスクリプションサービスを運営していると、避けて通れないのが 「決済失敗（Payment Failed）」 です。
「カードの有効期限切れ」や「限度額オーバー」で決済が落ちることは日常茶飯事。

しかし、「決済失敗 = 即解約」にしてしまうのは、ビジネスとしてあまりにも勿体ない ですよね。
ユーザーはサービスを辞めたいわけではなく、単にカード情報の更新を忘れているだけかもしれません。

今回は、開発者フレンドリーな決済サービス PAY.JP のWebhook機能を使い、「決済失敗をリアルタイムで検知し、n8n経由でユーザーにカード更新依頼を自動送信する」 仕組みを構築します。

🏗️ 全体アーキテクチャ

PAY.JPは決済に関するイベント（成功・失敗・定期課金作成など）が発生すると、即座にWebhookを飛ばしてくれます。これを利用します。

🛠️ PAY.JP側の設定：Webhookを受け取る

まず、PAY.JPの管理画面でWebhookのエンドポイントを設定します。

PAY.JP管理画面 > API > Webhook を開く。
n8nのWebhook URL（例: https://n8n.example.com/webhook/payjp-events）を入力。
通知するイベントタイプを選択。
- 今回は charge.failed（支払い失敗）と subscription.failed（定期課金失敗）にチェックを入れます。

PAY.JPのここが推せる！
PAY.JPはテスト環境でも本番と同じようにWebhookを飛ばしてくれます。開発中に「わざと失敗させるテスト」が非常にやりやすく、DX（開発者体験）が最高です。

⚙️ n8n側の実装：失敗イベントをハンドリング

n8nでWebhookを受け取り、イベントの種類によって処理を分岐させます。

1. Webhookノード

PAY.JPから送られてくるJSONペイロードを受け取ります。
charge.failed の場合、以下のようなデータが届きます。

PAY.JP Webhook Payload (例)

{
  "type": "charge.failed",
  "id": "ev_0000000000000000000000000",
  "data": {
    "id": "ch_0000000000000000000000000",
    "amount": 1000,
    "card": {
      "last4": "4242",
      "brand": "Visa",
      "customer": "cus_1234567890abcdef" 
    },
    "error": {
      "message": "The card was declined.",
      "code": "card_declined"
    }
  }
}

2. Switchノード（条件分岐）

イベントタイプ (body.type) を見て処理を分けます。

charge.succeeded → 成功（今回は無視、またはサンクスメール送信）
charge.failed → リカバリーフローへ

3. リカバリーメッセージの作成

ここが腕の見せ所です。事務的な「失敗しました」メールは読まれません。
「サービスが止まってしまうのを防ぐために、カード情報を更新してくださいね」 というニュアンスで、AI（ChatGPT）に文面を作らせるのも手です。

// メッセージ生成のイメージ
const customerId = $input.item.json.body.data.card.customer;
const amount = $input.item.json.body.data.amount;

return {
  message: `⚠️ 【重要】決済処理に失敗しました\n\nいつもご利用ありがとうございます。\n本日予定されておりました ${amount}円 の決済が完了できませんでした。\n\nサービスのご利用が一時停止される可能性があります。以下のリンクよりカード情報の更新をお願いいたします。\n\n👉 https://myapp.com/settings/billing`
};

4. 通知送信（LINE / SendGrid）

ユーザーの連絡先にメッセージを送信します。
LINE公式アカウントと連携していれば、プッシュ通知で届くため開封率が段違いです。

🛡️ セキュリティ対策：Webhook署名の検証

Webhookは外部から誰でも叩けるURLになってしまうため、「本当にPAY.JPから送られてきたものか？」 を検証する必要があります。
PAY.JPはヘッダーに X-Payjp-Signature を付与してくれるので、n8nの Cryptoノード を使って検証しましょう。

署名検証のロジック
公開鍵認証方式ではない場合でも、PAY.JPのWebhook設定画面にある「シークレットキー」を使ってHMAC-SHA256ハッシュを生成し、ヘッダーの署名と比較することで改ざんを検知できます。本番運用では必須の実装です！

📊 導入後の効果

この「自動リカバリーフロー」を導入することで、以下の効果が期待できます。

機会損失の防止: カード有効期限切れによる意図しない解約を阻止。
運用コスト削減: 「決済落ちてますよ」と手動でメールを送るオペレーションがゼロに。
ユーザー体験向上: サービスが突然止まる前に通知が来るため、ユーザーも安心。

まとめ

決済機能の実装というと「カード情報のトークン化」や「決済画面のUI」に目が行きがちですが、「決済した後（特に失敗した後）」の運用設計 こそが、SaaSの収益を支える要です。

PAY.JPの使いやすいWebhookとn8nを組み合わせれば、この「守りの要」をノーコード・ローコードで爆速構築できます。
ぜひ、あなたのサービスにも「鉄壁のリカバリーフロー」を導入してみてください！

最後に：業務委託のご相談を承ります

私は業務委託エンジニアとしてWEB制作やシステム開発を請け負っています。最新技術を活用したレスポンシブなWebサイト制作、インタラクティブなアプリケーション開発、API連携など幅広いご要望に対応可能です。

「課題解決に向けた即戦力が欲しい」「高品質なWeb制作を依頼したい」という方は、お気軽にご相談ください。一緒にビジネスの成長を目指しましょう！

👉 ポートフォリオ

🌳 らくらくサイト