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

公開：2025年10月29日更新：2025年10月29日

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

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

402エラー(Payment Required Experimental)とは

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

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

【PR】プログラミングや生成AIを無料で学べる「コードキャンプフリー」

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で確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。