エラーコード一覧表

クライアント起因

次のエラーコードはXGへのリクエスト内容に問題があるエラーです。

エラーコードに応じてエラーの原因を確認・修正をお願いします。

400番台エラーの内訳

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から各ストアへの通信過程でエラーが発生した状態です。

この場合は基本的にシーケンス記載のエラーハンドリング処理を行ってください。

また、下記エラーコード以外のエラー発生について既知の原因は次の通りです。

  • サーバーやデータベースが高負荷の場合

500番台エラーの内訳

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

未定義のエラー

原因不明のエラーを検知しました。