エラーハンドリング

API エラーに対するハンドリング方法、リトライ戦略について

PAY.JP API のエラーを適切に処理するための方法について説明します。エラーレスポンスの技術仕様については、エラーレスポンス仕様を参照してください。

エラーハンドリングについて

API レスポンスのステータスコードに応じて、適切なエラーハンドリングを実装することが重要です。

ステータス	対応方針
400 Bad Request	リクエストパラメータを確認し修正。自動リトライは不要
401 Unauthorized	API キーを確認
402 Payment Required	カード決済失敗。ユーザーに別の支払い方法を案内
404 Not Found	リソース ID を確認
409 Conflict	冪等キーの競合。詳細は冪等リクエストを参照
422 Unprocessable Entity	`errors` 配列の内容を確認しパラメータを修正
500, 503	サーバーエラー。リトライ可能

サーバーエラー（500, 503）やネットワークタイムアウトが発生した場合は、待機時間を徐々に長くしながらリトライすることを推奨します。