402エラー(Payment Required Experimental)とは？意味をわかりやすく簡単に解説

公開：2025年10月29日更新：2026年4月30日

CodeCampが提供するDX人材育成が可能なプログラミングやITが学べる公開講座

402エラー(Payment Required Experimental)とは
402エラーの技術仕様と動作メカニズム
402エラーの実装例とレスポンス構造

402エラー(Payment Required Experimental)とは

402エラーはHTTPステータスコードの一つであり、将来的な決済システムの実装を想定して予約されている実験的なコードです。HTTP/1.1の仕様において定義されていますが、現時点では標準的な使用方法が確立されておらず、実際のウェブサービスで採用される事例は極めて限定的となっています。

このステータスコードはリクエストされたリソースへのアクセスに対して、金銭的な支払いが必要であることをクライアントに通知する目的で設計されました。英名では「Payment Required」と呼ばれており、文字通り支払いが求められる状況を示すコードとして、将来的な電子商取引やデジタルコンテンツ配信での活用が期待されています。

Python研修一覧はこちら

目的に合うPython研修を一覧形式から探したい方は、ぜひご利用ください。

Python研修を比較する

Java研修一覧はこちら

目的に合うJava研修を一覧形式から探したい方は、ぜひご利用ください。

Java研修を比較する

PHP研修一覧はこちら

目的に合うPHP研修を一覧形式から探したい方は、ぜひご利用ください。

PHP研修を比較する

新入社員研修

目的に合う新入社員研修を一覧形式から探したい方は、ぜひご利用ください。

新入社員研修を比較する

全ての研修からも探したい方はこちら

402エラーの技術仕様と動作メカニズム

402エラーのレスポンスはサーバーがクライアントに対して、支払い情報の提供を要求する際に返されるHTTPステータスコードです。RFC 7231の規定では、このコードは将来の使用のために予約されており、現在のHTTP仕様では具体的な実装方法や決済プロトコルとの連携方式が明確に定義されていません。

項目	内容
ステータスコード	402
分類	4xxクライアントエラー
正式名称	Payment Required
規格	RFC 7231
実装状況	実験的・非標準

サーバーが402エラーを返す場合、レスポンスヘッダーに決済方法や料金情報を含めることが想定されていますが、標準化された形式は存在しません。一部のAPIプロバイダーでは、クレジット残高不足やサブスクリプション期限切れの通知として独自に402コードを採用しているケースがあり、このような実装ではWWW-Authenticateヘッダーや独自のヘッダーフィールドを用いて決済情報を伝達します。

402エラーの実装例とレスポンス構造

実際に402エラーを実装する場合、サーバーは適切なHTTPレスポンスヘッダーとボディを構成する必要があります。以下は、Node.jsのExpressフレームワークを使用した基本的な実装例であり、クライアントに決済が必要であることを明示的に通知する方法を示しています。

app.get('/premium-content', (req, res) => {
  if (!req.user.hasPaidSubscription) {
    res.status(402).json({
      error: 'Payment Required',
      message: 'このコンテンツにアクセスするには有料プランへの加入が必要です',
      paymentUrl: 'https://example.com/subscribe'
    });
  } else {
    res.json({ content: 'プレミアムコンテンツ' });
  }
});

このコード例ではユーザーの支払い状況を確認し、未払いの場合に402ステータスコードと共に、エラーメッセージと決済URLを返します。クライアント側では、このレスポンスを受け取った際に、決済ページへのリダイレクトや支払いモーダルの表示といった処理を実装でき、ユーザーに対して明確な次のアクションを提示することが可能です。

※上記コンテンツの内容やソースコードはAIで確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。