エラーコード一覧表¶
クライアント起因¶
次のエラーコードはXGへのリクエスト内容に問題があるエラーです。
エラーコードに応じてエラーの原因を確認・修正をお願いします。
HttpStatus |
エラーコード |
概要 |
説明 |
|---|---|---|---|
400 |
invalid_input |
入力値のエラー |
APIのパラメーターが間違っている時に発生します。 APIリファレンス を参照してパラメーターが正しいか確認をしてください。 |
401 |
authentication_failed |
認証エラー |
認証プロセスが失敗しました。表示されたエラーメッセージの箇所に問題が存在します。APIの認証処理について の記事を参照してください。 |
404 |
resource_not_found |
リソースエラー |
APIのリクエスト先が見つからない時に発生します。発生時は、URLのパスが間違っていないか確認してみてください。 |
400 |
application_not_found |
入力値のエラー |
ユーザー作成リクエスト時に「XG ProjectID」「XG AppID」が存在しない時に発生します。 |
400 |
invalid_user |
存在しないユーザー |
存在しないユーザーIDでリクエストを行った時に発生します。 |
400 |
invalid_store_id |
不正なストアID |
XG未対応のストアIDを指定した場合に発生します。 |
400 |
invalid_currency_id |
未登録の通貨ID |
パラメーターの「通貨ID」がXG側で未登録の場合に発生します。XG Developer Site経由で登録状態の確認をしてください。 |
400 |
invalid_product_id |
未登録の商品ID |
XGに未登録の商品IDを利用してリクエストを行った場合に発生します。商品IDの確認やXG Developer Site経由で商品情報の登録状態の確認をしてください。 |
400 |
transaction_id_conflict |
利用できないTransactionID |
TransactionIDがすでに利用されていた場合に発生します。TransactionIDはゲーム単位でユニークになるように調整をお願いします。 |
400 |
insufficient_balance |
ゲーム内通貨の残高不足 |
ゲーム内通貨の消費リクエスト時、残高が不足していました。 |
400 |
transaction_not_processed |
未処理の取引ID |
消費取消APIで未処理の取引IDを指定した場合に発生します。 APIリファレンス を参照してパラメーターが正しいか確認をしてください。 |
400 |
invalid_currency_expired |
不正なゲーム内通貨の有効期限設定 |
ゲーム内通貨の有効期限が無期限のレギュレーションのストア(AppStore)とゲーム内通貨を共有しているストアの有償通貨の有効期限が無期限になっていない場合に発生します。XG Developer Siteのアプリケーション設定を確認してください。 |
400 |
duplicate_game_user |
ゲームユーザーIDの重複エラー |
指定したゲームユーザーIDがすでに登録されている場合に発生します。 |
400 |
invalid_game_user_id |
存在しないゲームユーザー |
存在しないゲームユーザーIDを指定した場合に発生します。 |
400 |
googleplay_receipt_canceled |
購入キャンセル(Google Play) |
指定のTransactionID(PurchaseToken)の購入手続きは Google Play側でキャンセルが確認されていた時に発生します。 このエラーが発生した場合はリカバリーができません。購入処理を中断する対応をとってください。 |
400 |
googleplay_client_error |
Google Play API クライアントエラー |
Google Play Developer APIでクライアントエラーが発生しました。無効なTransactionIDを指定した場合などに発生します。 |
400 |
googleplay_receipt_consumed |
Google Play 消費済みのレシート |
すでに消費済みのレシートのTransactionIDを指定した場合に発生します。 |
400 |
googleplay_receipt_acknowledged |
Google Play 承認済みのレシート |
すでに承認済みのレシートのTransactionIDを指定した場合に発生します。 |
400 |
googleplay_different_product_type |
Google Play 商品タイプエラー |
リクエストの商品タイプと異なる商品タイプですでに処理済みの場合に発生します。 |
400 |
appstore_bad_request |
App Store Server API Bad Requestエラー |
App Store Server APIで400エラー( InvalidTransactionIdError )が発生しました。無効なTransactionIDを指定している可能性があります。リクエストで指定したTransactionIDが正しいかの確認をしてください。 |
400 |
appstore_unauthorized |
App Store Server API Unauthorizedエラー |
App Store Server APIで401エラー(Unauthorized)が発生しました。XG Developer Siteに登録したApp Storeの認証情報が間違っている可能性があります。登録した認証情報を確認してください。 |
400 |
appstore_transaction_id_not_found |
App Store Server API Not Foundエラー |
App Store Server APIで404エラー( TransactionIdNotFoundError )が発生しました。リクエストで指定したTransactionIDが正しいか確認してください。 |
400 |
appstore_price_error |
AppStore レシート検証 価格エラー |
XGに登録している商品の価格とレシートの価格が異なっています。 |
400 |
appstore_product_id_error |
AppStore レシート検証 productIdエラー |
リクエストのproductIdとレシートのproductIdが異なっています。 |
400 |
appstore_refunded_or_revoked |
AppStore レシート検証 返金エラー |
返金またはファミリー共有での取消しが行われています。このエラーが発生した場合はリカバリーができません。購入処理を中断する対応をとってください。 |
400 |
appstore_config_key_id_empty |
AppStore 認証情報エラー |
XGにキーIDが設定されていない場合に発生します。XG Developer Site経由で登録状態の確認をしてください。 |
400 |
appstore_config_issuer_id_empty |
AppStore 認証情報エラー |
XGにIssuer IDが設定されていない場合に発生します。XG Developer Site経由で登録状態の確認をしてください。 |
400 |
appstore_config_bundle_id_empty |
AppStore 認証情報エラー |
XGにバンドルIDが設定されていない場合に発生します。XG Developer Site経由で登録状態の確認をしてください。 |
400 |
appstore_config_api_key_empty |
AppStore 認証情報エラー |
XGにアプリ内課金キーが設定されていない場合に発生します。XG Developer Site経由で登録状態の確認をしてください。 |
400 |
appstore_config_api_key_invalid_format |
AppStore 認証情報エラー |
XGに登録したアプリ内課金キーが.p8 PEMファイル形式の秘密鍵でない場合に発生します。登録した認証情報を確認してください。 |
400 |
dmmgames_client_error |
DMM GAMES API クライアントエラー |
DMM GAMES APIでクライアントエラーが発生しました。無効なTransactionIDを指定した場合などに発生します。 |
400 |
dmmgames_receipt_canceled |
購入キャンセル(DMM GAMES) |
指定のTransactionID(PurchaseToken)の購入手続きは DMM GAMES 側でキャンセルが確認されていた時に発生します。 このエラーが発生した場合はリカバリーができません。購入処理を中断する対応をとってください。 |
400 |
dmmgames_product_id_error |
DMM GAMES レシート検証 productIdエラー |
リクエストのproductIdとレシートのproductIdが異なっています。 |
400 |
dmmgames_price_error |
DMM GAMES レシート検証 価格エラー |
XGに登録している商品の価格とレシートの価格が異なっています。 |
400 |
dmmgames_invalid_games_app_id |
DMM GAMES GAMESアプリIDエラー |
リクエストのGAMESアプリIDがXGに登録されていません。 |
400 |
debugger_disabled |
デバッグ機能が無効 |
デバッグ機能はサンドボックス環境でのみ提供しています。 |
400 |
mismatch_consume_store_id |
ストアID不一致エラー |
ゲーム内通貨の消費取消APIのリクエストで指定したストアIDがゲーム内通貨の消費時に指定したストアIDと異なる場合に発生します。 |
400 |
purchase_id_conflict |
利用できない購入ID |
すでに他のユーザーIDまたはストアIDで処理済みの購入IDを指定した場合に発生します。 |
サーバー起因¶
次のエラーコードはXG内部もしくはXGから各ストアへの通信過程でエラーが発生した状態です。
この場合は基本的にシーケンス記載のエラーハンドリング処理を行ってください。
また、下記エラーコード以外のエラー発生について既知の原因は次の通りです。
サーバーやデータベースが高負荷の場合
HttpStatus |
エラーコード |
概要 |
説明 |
|---|---|---|---|
500 |
database_error |
データベースエラー |
XGのデータベース起因のエラーが発生しています。XGサポートにお問い合わせください。 |
500 |
user_id_generation_failed |
ユーザーIDの作成失敗 |
XG側でユーザーIDの新規作成に失敗しました。 XGサポートにお問い合わせください。 |
503 |
service_timeout |
サービス利用不可 |
サーバー側でサービス利用できない状況が発生しました。時間をあけて再度アクセスしてください。 |
500 |
googleplay_server_error |
ストアへの通信エラー(Google Play) |
Google Play側へ取引内容の確認中にエラーが発生しました。 リカバリーの手順 に従ってリクエストをしてください。 |
500 |
googleplay_receipt_pending |
決済処理中(Google Play) |
Google Play側で決済が完了していないため処理を中断しました。 リカバリーの手順 に従ってリクエストをしてください。 |
500 |
googleplay_request_timeout |
タイムアウト |
Google Play Developer API へのリクエスト処理がタイムアウトしました。 リカバリーの手順 に従ってリクエストをしてください。 |
500 |
appstore_internal_server_error |
App Store Server API サーバーエラー |
App Store Server APIで500エラー( GeneralInternalError または GeneralInternalRetryableError )が発生しました。 リカバリーの手順 に従ってリクエストをしてください。 |
500 |
appstore_request_timeout |
タイムアウト |
App Store Server API へのリクエスト処理がタイムアウトしました。 リカバリーの手順 に従ってリクエストをしてください。 |
500 |
appstore_rate_limit_exceeded |
App Store Server API レート制限エラー |
App Store Server APIで429エラー( RateLimitExceededError )が発生しました。 リカバリーの手順 に従ってリクエストをしてください。 |
500 |
dmmgames_internal_server_error |
DMM GAMES API サーバーエラー |
DMM GAMES APIで500エラー(InternalServerError)が発生しました。 リカバリーの手順 に従ってリクエストをしてください。 |
500 |
dmmgames_request_timeout |
タイムアウト |
DMM GAMES API へのリクエスト処理がタイムアウトしました。 リカバリーの手順 に従ってリクエストをしてください。 |
500 |
debugger_error |
デバッグ機能エラー |
デバッグ条件のパラメーターの設定に問題がありました。詳しくは デバッグ機能 を参考してください。 |
500 |
unknown_error |
未定義のエラー |
原因不明のエラーを検知しました。 |