# Stripe 稼働状況のお知らせ

お知らせとインサイトを活用し、API 連携の稼働状況を監視します。

Stripe の稼働状況のお知らせでは、決済フローや Stripe 製品との連携に影響する問題について、リアルタイムモニタリングと自動通知を利用できます。リクエストエラー、取引件数、またはレイテンシーにおける予期しない傾向をチームに通知します。これらの傾向を評価し、決済処理や Stripe 製品の利用に支障がないかを確認してください。

> 稼働状況のお知らせの利用は、お客様の責任で行ってください。お知らせの正確性または不正確性、およびお知らせに基づいて実施または見送ったアクションに関連するいかなる損失、損害、または費用についても、Stripe は一切の責任を負いません。

## サポート状況

Stripe アカウントに応じて、稼働状況のお知らせを受け取ることができます。

### 稼働状況のお知らせ段階

- **基本段階**: すべての Stripe ユーザーは、`402` (パートナーの停止による決済拒否)および `500` (Stripe の停止による API リクエスト失敗)の[エラーステータスコード](https://docs.stripe.com/health-alerts.md#error-status-codes-for-api-error-alerts)の稼働状況のお知らせをメールとワークベンチで受け取ります。
- **アドバンス段階**: Stripe の [Growth、Premium、Enterprise サポートプラン](https://stripe.com/support-plans)のユーザーは、メール、ワークベンチ、Webhook イベントで稼働状況のお知らせを受け取り、[より詳細なアラート](https://docs.stripe.com/health-alerts.md#advanced-tier-alert-categories)を確認できます。

### Connect

[Connect](https://docs.stripe.com/connect.md) プラットフォームの場合、稼働状況のお知らせには、プラットフォームアカウントとそれに対応する連結アカウントの両方のアラートが含まれます。

### Organizations

[Stripe Organizations](https://docs.stripe.com/get-started/account/orgs.md) を使用すると、ワークベンチですべてのアカウントのアラートとインサイトを単一のビューで表示できます。

## 通信チャネル

Stripe は、以下の通信チャネルを通じて稼働状況のお知らせをお客様に通知し、Stripe エコシステムの問題と、該当する場合は次のステップについてチームに通知します。

| チャネル | 通知 |
| --- | --- |
| メール通知 | Stripe は、設定されているメールアドレスまたは配布リストにメールアラートを送信します。 |
| ワークベンチの稼働状況タブ | [ワークベンチ](https://docs.stripe.com/workbench/health.md)のインタラクティブなタブ。重大度、ステータス (未解決または解決済み)、影響を受けたリクエストなど、アラートの 30 日間の履歴が表示されます。 |
| Webhook イベント | Stripe アカウントで ヘルスイベント が発生すると、アラートがリアルタイムイベントとしてアプリケーションの Webhook エンドポイントに送信されます。これらのイベントを Slack や Pagerduty などの内部通知システムと統合することを検討してください。 |

## ヘルスアラートの設定

Stripe アカウントの管理者は、**設定** > [通信設定](https://dashboard.stripe.com/settings/communication-preferences#api)で基本段階の稼働状況のお知らせをオプトインまたはオプトアウトできます。

アドバンス段階の稼働状況のお知らせのメールアドレスまたは配布リストを設定するには、テクニカルアカウントマネージャーにお問い合わせください。

アドバンス段階の稼働状況のお知らせを受け取る [Stripe Organization](https://docs.stripe.com/get-started/account/orgs.md) の管理者は、**設定** > [コミュニケーション管理](https://dashboard.stripe.com/org/settings/communication-management)で組織内のすべてのアカウントの設定を管理できます。

## 基本段階アラートカテゴリー

### API エラーの増加

これらのアラートは、ほとんどの Stripe Payments 製品に関連する API リクエストを追跡します。連携の決済処理能力に影響を与える可能性のある問題について通知します。API エラー増加アラートのエラーステータスコードには、402 と 500 が含まれます。[エラーコード](https://docs.stripe.com/error-codes.md)とその解決方法の詳細をご覧ください。

Stripe は以下について API エラー増加アラートを送信します。

| プロダクト | アラートの説明 |
| --- | --- |
| [Payment Intents API](https://docs.stripe.com/payments/payment-intents.md) | 通常、これらのアラートは、[PaymentIntents](https://docs.stripe.com/api/payment_intents.md) の設定、管理、確定、キャプチャーに関連する API イベントのエラーにより発生します。 |
| [Bank Accounts API](https://docs.stripe.com/api/customer_bank_accounts.md) | これらのアラートは、ユーザーと金融機関 (銀行など) 間の安全な接続の確立に関するエラー、および財務データの取得と接続セッションの認証に関する問題について扱います。この連携により、口座情報や取引詳細などのデータ交換が容易になります。 |
| [Stripe Terminal](https://docs.stripe.com/terminal.md) | 以下のような Terminal 特有の API アクションに対応しています。
- [トークンの設定と有効化](https://docs.stripe.com/api/terminal/connection_tokens/object.md)
- [返金の作成](https://docs.stripe.com/api/terminal/readers/refund_payment.md)
- [デバイスの構成証明](https://docs.stripe.com/api/terminal/readers/object.md)
- [支払いインテントの処理](https://docs.stripe.com/api/errors.md) |
| [Stripe Issuing](https://docs.stripe.com/issuing.md) | [Issuing API](https://docs.stripe.com/api/issuing/authorizations.md) に関連するリクエスト失敗アラートは、Stripe が発行した決済カードの認証、オーソリ、作成、取得、更新について扱います。 |

#### API エラーアラートのエラーステータスコード

| エラーステータスコード | 考えられる原因 |
| --- | --- |
| `402` | リクエストには有効なパラメーターが含まれていたが、金融取引または決済手段の検証の問題により失敗したことを示します。 |
| `424` | API リクエストが以前のアクションに依存し、その以前のアクションが失敗したためにリクエストが失敗した場合に発生します。 |
| `500` | Stripe のサーバー側の問題を示します。まれなケースですが、これらのエラーはサーバーに問題があるか、ユーザー側で問題のあるコールが原因でタイムアウトが発生した可能性があります。Stripe は常に `500` エラーを調査し、解決されたら通知します。 |

### 支払い方法のエラー

決済手段のエラーの増加は、指定された決済手段での[決済拒否](https://docs.stripe.com/declines.md)の増加を示しています。これは、決済手段、カード発行会社、または Stripe の技術的な問題が原因となっている可能性があります。決済手段によっては通知遅延 ([ACH Direct Debit](https://docs.stripe.com/payments/ach-direct-debit.md) など)が発生し、遅延中に決済ステータスを確認できないことがあります。

決済の`処理`成功ステータスは、決済が`失敗し`たか`成功し`たかをまだ Stripe が確認できないことを意味します。[即時通知または通知遅延型](https://docs.stripe.com/payments/payment-methods.md#payment-notification)の詳細をご覧ください。

## アドバンス段階アラートカテゴリー

基本段階のアラートカテゴリーに加えて、アドバンス段階のお客様には、次のアラートカテゴリーも提供されます。

### 統合エラーの増加

これらのアラートは、レート制限の問題など、連携の決済機能に影響するエラーを監視します。決済処理機能に影響する可能性のある Stripe 連携の問題を通知します。連携エラー増加アラートのエラーステータスコードには、400、409、429 が含まれます。[エラーコード](https://docs.stripe.com/error-codes.md)とその解決方法の詳細をご覧ください。

#### 統合エラーアラート用のエラーステータスコード

| エラーステータスコード | 考えられる原因 |
| --- | --- |
| `400` | サーバーが構文を理解できない、不正な形式のリクエストであることを示します。アラートメッセージで指定されている API メソッドについて、連携状況を確認します。 |
| `409` | すでにあるリソースを作成しようとしたときなど、競合が発生した場合に発生します。 |
| `429` | エラーは多くの場合、特定の期間に送信されたリクエストがレート制限を超えている場合に起こります。このエラーカテゴリーの増加は、必須パラメーターが省略されていることを意味します。 |

### API レイテンシー

API レイテンシー指標は、特定の API メソッドについて、Stripe アカウントごとの遅延のばらつきを測定します。遅延が長いアラートは、決済処理に問題が発生している可能性があることを示唆し、タイムリーな応答を徹底するために Stripe の監視対象となります。

### 異常アラート

異常アラートは、機械学習 (ML) を使用して、決済パフォーマンスの急落や変化をほぼリアルタイムで検出します。次の表は、さまざまな異常アラートタイプについて説明しています。

| 異常アラート | 説明 |
| --- | --- |
| **カードのオーソリ失敗** | [ネットワークのオーソリ成功率](https://docs.stripe.com/payments/analytics/acceptance.md)が急激に低下し、カード決済全体の成功率に影響が及んでいます。これらのアラートは、影響を受けたカード発行会社など、低下した決済トラフィックのサブセットを示します。カードネットワークまたは発行会社におけるパートナーの障害が低下の原因と疑われる場合は、メッセージ内にその旨が示されます。オーソリ成功率を高めるために実行できるアクションについては、Stripe ガイドの[ネットワークによる支払い拒否を減らす方法](https://stripe.com/guides/optimizing-authorization-rates#how-to-increase-authorization-rates)を参照してください。 |
| **Terminal での承認失敗** | Terminal での決済の突然の失敗。これらのアラートは、Stripe が Terminal デバイス全体で決済承認の大幅な減少を検出すると、事前に通知します。これらの通知は、主要なカードネットワークやローカルデビットシステムなど、サポートされているすべての決済手段を対象としており、処理の問題を特定して対処するのに役立ちます。 |
| **不正利用取引の増加** (Private preview) | [不正利用](https://docs.stripe.com/disputes/prevention.md)の急増により、損失のリスクが増大します。 |
| **決済量の減少** (Private preview) | 機械学習 (ML) を使用して、週次変動と季節変動を考慮しながら、決済量の減少をユーザーに通知するアラートです。減少の原因としては、Stripe アカウント設定のエラー、ウェブサイトやモバイルアプリの定期メンテナンス、ビジネスの季節変動など、複数の要因が考えられます。 |

### Webhook の遅延アラート

サービスの中断を最小限に抑えるため、Stripe は Webhook の遅延の変化を監視し、リアルタイム更新を迅速に配信できるようにしています。Webhook 固有のエラーとアラートについては、[エラー](https://docs.stripe.com/api/errors.md#errors-code)で詳細を確認してください。

### Issuing リクエストのタイムアウト (Private preview)

[Stripe Issuing](https://docs.stripe.com/issuing.md) の Webhook オーソリリクエストで頻繁にタイムアウトが発生している場合、Issuing リクエストでタイムアウトが発生します。これらのオーソリリクエストは、ダッシュボードの [Issuing](https://dashboard.stripe.com/settings/issuing/authorizations) ページの設定を確認するようにチームに通知します。

設定を確認するには、ダッシュボードで**設定**\>**発行**\>**オーソリ**\>**承認**に移動します。

### Issuing エラー (Private preview)

[Stripe Issuing](https://docs.stripe.com/issuing.md) では、Issuing 導入での Webhook オーソリタイムアウトを監視します。Issuing オーソリリクエストの Webhook タイムアウトが増加した場合は、通知します。

### 請求方法のエラー (Private preview)

請求方法のエラーと Stripe の[従量課金](https://stripe.com/billing/usage-based-billing)エラーを監視します。

## テストの稼働状況のお知らせとインサイトを生成する

ワークベンチのブループリントタブから、テストの稼働状態アラートとインサイトを生成できます。テストのアラートは稼働状態タブに表示されますが、メール通知は送信されません。

## See also

- [ワークベンチ稼働状況のお知らせ](https://docs.stripe.com/workbench/health.md)
- [Stripe API エラーコード](https://docs.stripe.com/api/errors.md#errors-code)