# LaravelでStripeのWebhookを使った決済ステータス管理

## 1. イントロダクション
Stripeはオンラインでの支払いを簡単に処理できる人気のあるプラットフォームです。LaravelでStripeを活用することで、オンライン決済を効果的に管理できます。本記事では、StripeのWebhookを使って、決済ステータスの管理を行う方法を詳しく解説します。

## 2. Webhookの概要
### 2.1 Webhookとは？
Webhookとは、特定のイベントが発生した際に指定したURLにHTTPリクエストを送信する仕組みです。Stripeでは、支払いが成功した、支払いが失敗したなどのイベントに応じて自動で通知が送られてきます。

### 2.2 StripeにおけるWebhookの具体例
- `invoice.payment_succeeded`
- `invoice.payment_failed`
- `charge.refunded`

## 3. Stripe APIのセットアップ
### 3.1 APIキーの取得
まず、StripeダッシュボードからAPIキーを取得します。このAPIキーはStripeとの通信を行うために必要です。

### 3.2 Laravelでの初期設定
StripeのAPIを使用するためのライブラリである`stripe/stripe-php`をインストールします。
```bash
composer require stripe/stripe-php
```

### 3.3 環境設定
Laravelの`.env`ファイルに以下を追加し、APIキーを設定します。
```env
STRIPE_SECRET_KEY=sk_test_XXXXXXXXXXXXXXXXXXXXXXXX
STRIPE_WEBHOOK_SECRET=whsec_XXXXXXXXXXXXXXXXXXXXXX
```

## 4. Webhookのハンドラの設定
### 4.1 ルート設定
```php
// routes/web.php
use App\Http\Controllers\WebhookController;
Route::post('/webhook/stripe', [WebhookController::class, 'handle']);
```

### 4.2 コントローラの作成
```php
// app/Http/Controllers/WebhookController.php
namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Log;
use Stripe\Webhook;

class WebhookController extends Controller
{
    public function handle(Request $request)
    {
        $endpointSecret = config('services.stripe.webhook_secret');
        $payload = $request->getContent();
        $sigHeader = $request->header('Stripe-Signature');

        try {
            $event = Webhook::constructEvent($payload, $sigHeader, $endpointSecret);
        } catch (\UnexpectedValueException $e) {
            // 無効なペイロード
            return response()->json(['error' => 'Invalid payload'], 400);
        } catch (\Stripe\Exception\SignatureVerificationException $e) {
            // 無効な署名
            return response()->json(['error' => 'Invalid signature'], 400);
        }

        // イベントタイプによって処理を分岐
        switch ($event->type) {
            case 'invoice.payment_succeeded':
                $this->handlePaymentSucceeded($event->data->object);
                break;
            case 'invoice.payment_failed':
                $this->handlePaymentFailed($event->data->object);
                break;
            // 必要に応じて他のイベントも追加
            default:
                return response()->json(['message' => 'Event type not handled'], 200);
        }

        return response()->json(['message' => 'Webhook Handled'], 200);
    }

    private function handlePaymentSucceeded($invoice)
    {
        // 成功時の処理
        Log::info('Payment Succeeded: '. $invoice->id);
    }

    private function handlePaymentFailed($invoice)
    {
        // 失敗時の処理
        Log::error('Payment Failed: '. $invoice->id);
    }
}
```

## 5. 希望する動作確認
### 5.1 Stripe CLIの利用
Stripe CLIを使ってWebhookのテストが可能です。
```bash
stripe listen --forward-to localhost:8000/webhook/stripe
```
そして、以下のコマンドでテストイベントを送信できます。
```bash
stripe trigger invoice.payment_succeeded
```

## 6. セキュリティに関する注意点
Webhookで受け取ったデータは慎重に扱う必要があります。具体的な例として、Webhookシークレットを必ず検証するようにしましょう。このシークレットを使って、受け取ったイベントが本当にStripeからのものであるかという確認を行います。

## 7. まとめ
StripeのWebhookを利用することで、支払いに関するリアルタイムなイベントをハンドリングできます。本記事で紹介した方法を活用し、多様な決済シナリオに対応したアプリケーションを開発してください。エラーハンドリングやセキュリティの実装もお忘れなく、健全なシステム運用を心がけましょう。

[cv:issue_marketplace_engineer]

LaravelでStripeのWebhookを使った決済ステータス管理

1. イントロダクション

2. Web

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