# Stripe の `invoice.payment_succeeded` を処理する方法

## 目次
1. はじめに
2. `invoice.payment_succeeded` イベントとは
3. イベントのハンドリング準備
   - 3-1. Webhook エンドポイントの設定
   - 3-2. セキュリティの考慮
4. イベント処理の実装
   - 4-1. Node.js を使用した例
   - 4-2. Python を使用した例
5. イベントハンドラが行うべき処理
   - 5-1. 顧客データの更新
   - 5-2. サービスの有効化
   - 5-3. 通知の送信
6. まとめ

## 1. はじめに

Stripe において `invoice.payment_succeeded` イベントは、定期的な請求書の支払いが成功したことを示します。このイベントを適切に処理することで、継続的なサービス提供に必要な顧客管理が可能になります。この記事では、Stripe の `invoice.payment_succeeded` イベントを受け取り、処理する方法を詳しく説明します。

## 2. `invoice.payment_succeeded` イベントとは

`invoice.payment_succeeded` イベントは、顧客が送信された請求書の支払いを正常に完了したときに Stripe が発行するイベントです。このイベントを利用することで、ユーザーアカウントを更新したり、サービスの提供を開始したりすることが可能です。

## 3. イベントのハンドリング準備

Stripe のイベントを処理するためには、Webhook エンドポイントを設定しなければなりません。

### 3-1. Webhook エンドポイントの設定

1. Stripe ダッシュボードにログインして、Webhook 設定ページにアクセスします。
2. 「Webhooks」セクションで新しいエンドポイントを追加し、URL を指定します。
3. リスニングしたいイベントとして `invoice.payment_succeeded` を選択します。

### 3-2. セキュリティの考慮

Stripe からのリクエストが正当なものであることを確認するために、署名シークレットを使用して Webhook の検証を行います。

## 4. イベント処理の実装

ここでは、Node.js と Python を使用して `invoice.payment_succeeded` イベントを処理する例を示します。

### 4-1. Node.js を使用した例

![img](/mosaic-code.jpg)

### 4-2. Python を使用した例

![img](/mosaic-code.jpg)

## 5. イベントハンドラが行うべき処理

### 5-1. 顧客データの更新

顧客データベースを更新し、支払いが成功したことを登録します。

### 5-2. サービスの有効化

顧客が支払ったサービスを開始または更新します。

### 5-3. 通知の送信

顧客に対して支払い完了の通知をメールまたはアプリ内で送信します。

## 6. まとめ

Stripe の `invoice.payment_succeeded` イベントは、サブスクリプションサービスの自動化において非常に重要です。適切な Webhook を設定し、イベントに基づいた即時の処理を行うことで、ユーザー体験の向上や管理の効率化が図れます。各種フレームワークやプログラミング言語で容易に実装可能なため、ビジネスに合わせたカスタマイズも可能です。 [cv:issue_marketplace_engineer]

# Stripe の `invoice.payment_succeeded` を処理する方法

## 目次
1. はじめに
2. `invoice.payment_succeeded` イベントとは
3. イベントのハンドリング準備
   - 3-1. Webhook エンドポイントの設定
   - 3-2. セキュリティの考慮
4. イベント処理の実装
   - 4-1. Node.js を使用した例
   - 4-2. Python を使用した例
5. イベントハンドラが行うべき処理
   - 5-1. 顧客データの更新
   - 5-2. サービスの有効化
   - 5-3. 通知の送信
6. まとめ

## 1. はじめに

Stripe において `invoice.payment_succeeded` イベントは、定期的な請求書の支払いが成功したことを示します。このイベントを適切に処理することで、継続的なサービス提供に必要な顧客管理が可能になります。この記事では、Stripe の `invoice.payment_succeeded` イベントを受け取り、処理する方法を詳しく説明します。

## 2. `invoice.payment_succeeded` イベントとは

`invoice.payment_succeeded` イベントは、顧客が送信された請求書の支払いを正常に完了したときに Stripe が発行するイベントです。このイベントを利用することで、ユーザーアカウントを更新したり、サービスの提供を開始したりすることが可能です。

## 3. イベントのハンドリング準備

Stripe のイベントを処理するためには、Webhook エンドポイントを設定しなければなりません。

### 3-1. Webhook エンドポイントの設定

1. Stripe ダッシュボードにログインして、Webhook 設定ページにアクセスします。
2. 「Webhooks」セクションで新しいエンドポイントを追加し、URL を指定します。
3. リスニングしたいイベントとして `invoice.payment_succeeded` を選択します。

### 3-2. セキュリティの考慮

Stripe からのリクエストが正当なものであることを確認するために、署名シークレットを使用して Webhook の検証を行います。

## 4. イベント処理の実装

ここでは、Node.js と Python を使用して `invoice.payment_succeeded` イベントを処理する例を示します。

### 4-1. Node.js を使用した例

```javascript
const express = require('express');
const bodyParser = require('body-parser');
const stripe = require('stripe')('your-secret-key');

const app = express();

// Use the raw body
app.use(bodyParser.raw({type: 'application/json'}));

app.post('/webhook', (req, res) => {
  const sig = req.headers['stripe-signature'];

  try {
    const event = stripe.webhooks.constructEvent(req.body, sig, 'your-webhook-secret');
    if (event.type === 'invoice.payment_succeeded') {
      const invoice = event.data.object;
      // Here you can handle the successful payment
      console.log(`Invoice ${invoice.id} payment succeeded for customer ${invoice.customer}.`);
    }
    res.json({received: true});
  } catch (err) {
    console.log(`⚠️  Webhook signature verification failed.`, err.message);
    res.status(400).end();
  }
});

app.listen(3000, () => console.log('Running on port 3000'));
```

### 4-2. Python を使用した例

```python
import stripe
from flask import Flask, request, jsonify

app = Flask(__name__)
stripe.api_key = 'your-secret-key'

@app.route('/webhook', methods=['POST'])
def webhook_received():
    payload = request.get_data(as_text=True)
    sig_header = request.headers.get('Stripe-Signature')

    try:
        event = stripe.Webhook.construct_event(
            payload, sig_header, 'your-webhook-secret'
        )

        if event['type'] == 'invoice.payment_succeeded':
            invoice = event['data']['object']
            # Successful payment handling
            print(f"Invoice {invoice['id']} payment succeeded for customer {invoice['customer']}.")

        return jsonify(success=True)
    except ValueError as e:
        # Invalid payload
        print("Invalid payload")
        return str(e), 400
    except stripe.error.SignatureVerificationError as e:
        # Invalid signature
        print("Invalid signature")
        return str(e), 400

if __name__ == '__main__':
    app.run(port=3000)
```

## 5. イベントハンドラが行うべき処理

### 5-1. 顧客データの更新

顧客データベースを更新し、支払いが成功したことを登録します。

### 5-2. サービスの有効化

顧客が支払ったサービスを開始または更新します。

### 5-3. 通知の送信

顧客に対して支払い完了の通知をメールまたはアプリ内で送信します。

## 6. まとめ

Stripe の `invoice.payment_succeeded` イベントは、サブスクリプションサービスの自動化において非常に重要です。適切な Webhook を設定し、イベントに基づいた即時の処理を行うことで、ユーザー体験の向上や管理の効率化が図れます。各種フレームワークやプログラミング言語で容易に実装可能なため、ビジネスに合わせたカスタマイズも可能です。 [![image](https://firebasestorage.googleapis.com/v0/b/issue-pro-42602.appspot.com/o/topics%2F17fa658b-53c7-4ca0-a28b-e588ed1bd371?alt=media&token=2c00afff-85ff-4428-8d15-696ab676dcb0)](https://i-ssue.com/lp/check_salary)

Stripe の invoice.payment_succeeded を処理する方法

目次

続きを読むには単価診断を受けてください（30秒）

Stripe の `invoice.payment_succeeded` を処理する方法