# 目次

1. はじめに
2. Stripe Webhookの基礎
3. StripeアカウントのKYCステータス
4. Webhookの設定方法
5. コードサンプル
6. 利用上の注意点
7. よくある質問
8. まとめ

## 1. はじめに
KYC（Know Your Customer）とは、顧客の本人確認手続きを指します。Stripeは、決済プラットフォームとして利用者の信頼性を高めるために、KYCプロセスを導入しています。このガイドでは、StripeのWebhookを通じてアカウントのKYCステータスを取得する方法を解説します。

## 2. Stripe Webhookの基礎
Webhookは、特定のイベントが発生した際に、外部のシステムに通知を送信する仕組みです。Stripeでは、様々なイベントをWebhookを通じて通知できます。KYCステータスに関連する通知を受け取るためには、適切なWebhookの設定が必要です。

## 3. StripeアカウントのKYCステータス
Stripeは、アカウントの検証状態を別々のステータスで表現します。例えば、`pending`, `verified`, `unverified`などのステータスがあります。これらのステータスを把握することで、アカウントの信頼性や利用状況を判断できます。

## 4. Webhookの設定方法
StripeダッシュボードからWebhookを設定することで、特定のイベントが発生した際に、事前に指定したURLに通知を送信することが可能です。

### 手順
1. Stripeダッシュボードにログインし、「Developers」→「Webhooks」を選択します。
2. 「Add endpoint」をクリックして、新しいWebhookエンドポイントを追加します。
3. 「Endpoint URL」に通知を受け取るサーバーのURLを入力します。
4. 「Events to send」で`account.updated`イベントを選択します。
5. 設定を保存してWebhookのリスニングを開始します。

## 5. コードサンプル
次に、Node.jsを使用してWebhookを実装する簡単な例を示します。ここでは`express`を使用しています。

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

## 6. 利用上の注意点
- Webhookのエンドポイントはインターネット上で公開されるため、認証やフィルタリングを適切に設定しましょう。
- セキュリティの観点から、すべてのWebhookリクエストの署名を検証してください。
- ステージング環境と本番環境で異なるWebhook URLを使用し、環境を分けて管理しましょう。

## 7. よくある質問

### 1. Webhookのイベントが受信されないのはなぜですか？
- URLが正しく設定されているか確認しましょう。
- サーバーが外部からの接続を受け入れるように設定されていますか？
- Stripeダッシュボードでイベントタイプが正しく選択されているか確認します。

### 2. Webhookのリトライはありますか？
- はい、Stripeでは一時的な障害が発生した場合に備えて、Webhook通知を何度かリトライします。

## 8. まとめ
StripeのKYCステータスをWebhookで取得することにより、アカウントの本人確認状況をリアルタイムで把握でき、ビジネスの信頼性向上に役立ちます。アプリケーションのセキュリティを高めるためには、Webhook通信のセキュリティ対策に注意し、必要に応じて署名の検証を行うことが重要です。 [cv:issue_marketplace_engineer]

# 目次

1. はじめに
2. Stripe Webhookの基礎
3. StripeアカウントのKYCステータス
4. Webhookの設定方法
5. コードサンプル
6. 利用上の注意点
7. よくある質問
8. まとめ

## 1. はじめに
KYC（Know Your Customer）とは、顧客の本人確認手続きを指します。Stripeは、決済プラットフォームとして利用者の信頼性を高めるために、KYCプロセスを導入しています。このガイドでは、StripeのWebhookを通じてアカウントのKYCステータスを取得する方法を解説します。

## 2. Stripe Webhookの基礎
Webhookは、特定のイベントが発生した際に、外部のシステムに通知を送信する仕組みです。Stripeでは、様々なイベントをWebhookを通じて通知できます。KYCステータスに関連する通知を受け取るためには、適切なWebhookの設定が必要です。

## 3. StripeアカウントのKYCステータス
Stripeは、アカウントの検証状態を別々のステータスで表現します。例えば、`pending`, `verified`, `unverified`などのステータスがあります。これらのステータスを把握することで、アカウントの信頼性や利用状況を判断できます。

## 4. Webhookの設定方法
StripeダッシュボードからWebhookを設定することで、特定のイベントが発生した際に、事前に指定したURLに通知を送信することが可能です。

### 手順
1. Stripeダッシュボードにログインし、「Developers」→「Webhooks」を選択します。
2. 「Add endpoint」をクリックして、新しいWebhookエンドポイントを追加します。
3. 「Endpoint URL」に通知を受け取るサーバーのURLを入力します。
4. 「Events to send」で`account.updated`イベントを選択します。
5. 設定を保存してWebhookのリスニングを開始します。

## 5. コードサンプル
次に、Node.jsを使用してWebhookを実装する簡単な例を示します。ここでは`express`を使用しています。

```javascript
const express = require('express');
const bodyParser = require('body-parser');
const stripe = require('stripe')('YOUR_STRIPE_SECRET_KEY');

const app = express();

// Use the raw body to verify the signature
app.post('/webhook', bodyParser.raw({type: 'application/json'}), (req, res) => {
  const sig = req.headers['stripe-signature'];

  let event;

  try {
    event = stripe.webhooks.constructEvent(req.body, sig, 'YOUR_ENDPOINT_SECRET');
  } catch (err) {
    console.error('Webhook signature verification failed.', err.message);
    return res.sendStatus(400);
  }

  if (event.type === 'account.updated') {
    const account = event.data.object;
    console.log(`Account ID: ${account.id}, KYC Status: ${account.individual.verification.status}`);
    // Handle the KYC status update
  }

  res.json({received: true});
});

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

## 6. 利用上の注意点
- Webhookのエンドポイントはインターネット上で公開されるため、認証やフィルタリングを適切に設定しましょう。
- セキュリティの観点から、すべてのWebhookリクエストの署名を検証してください。
- ステージング環境と本番環境で異なるWebhook URLを使用し、環境を分けて管理しましょう。

## 7. よくある質問

### 1. Webhookのイベントが受信されないのはなぜですか？
- URLが正しく設定されているか確認しましょう。
- サーバーが外部からの接続を受け入れるように設定されていますか？
- Stripeダッシュボードでイベントタイプが正しく選択されているか確認します。

### 2. Webhookのリトライはありますか？
- はい、Stripeでは一時的な障害が発生した場合に備えて、Webhook通知を何度かリトライします。

## 8. まとめ
StripeのKYCステータスをWebhookで取得することにより、アカウントの本人確認状況をリアルタイムで把握でき、ビジネスの信頼性向上に役立ちます。アプリケーションのセキュリティを高めるためには、Webhook通信のセキュリティ対策に注意し、必要に応じて署名の検証を行うことが重要です。 

目次

1. はじめに

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