Capacitor SDKでエラーを処理する

SDKが返すエラーはすべて AdaptyError インスタンスです。以下はその例です。

Tip

デバッグ前に詳細ログを有効にしてください。 ほとんどの AdaptyError は、StoreKit、Play Billing、ネットワーク、またはバックエンドのエラーをラップしています。詳細ログを有効にすると（adapty.setLogLevel({ logLevel: 'verbose' }) — ログ設定を参照）、ラップされたエラーがコンソールに出力され、実際の原因がわかります。AdaptyError の detail プロパティはログレベルに関係なく値が入っていますが、詳細ログを使うとコンソールにも表示されます。


try {
  const result = await adapty.makePurchase({ product });
  
  // Handle purchase result
  if (result.type === 'success') {
    console.log('Purchase successful:', result.profile);
  } else if (result.type === 'user_cancelled') {
    console.log('User cancelled the purchase');
  } else if (result.type === 'pending') {
    console.log('Purchase is pending');
  }
} catch (error) {
  if (error instanceof AdaptyError) {
    console.error('Adapty error:', error.adaptyCode, error.localizedDescription);
    
    // Handle specific error codes
    switch (error.adaptyCode) {
      case ErrorCodeName.cantMakePayments:
        console.log('In-app purchases are not allowed on this device');
        break;
      case ErrorCodeName.notActivated:
        console.log('Adapty SDK is not activated');
        break;
      case ErrorCodeName.productPurchaseFailed:
        console.log('Purchase failed:', error.detail);
        break;
      default:
        console.log('Other error occurred:', error.detail);
    }
  } else {
    console.error('Non-Adapty error:', error);
  }
}

エラープロパティ

AdaptyErrorクラスは以下のプロパティを提供します：

プロパティ	型	説明
`adaptyCode`	`number`	数値エラーコード（例：`cantMakePayments`の場合は`1003`）
`localizedDescription`	`string`	ユーザー向けのエラーメッセージ
`detail`	`string \| undefined`	追加のエラー詳細（任意）
`message`	`string`	コードと説明を含む完全なエラーメッセージ

エラーコード

SDKはエラーコードを扱うための定数とユーティリティをエクスポートしています：

ErrorCodeName定数

文字列識別子を数値コードにマッピングします：


ErrorCodeName.cantMakePayments // 1003
ErrorCodeName.notActivated // 2002
ErrorCodeName.networkFailed // 2005

ErrorCode定数

数値コードを文字列識別子にマッピングします：


ErrorCode[1003] // 'cantMakePayments'
ErrorCode[2002] // 'notActivated'
ErrorCode[2005] // 'networkFailed'

ヘルパー関数


// Get numeric code from string name:
getErrorCode('cantMakePayments') // 1003

// Get string name from numeric code:
getErrorPrompt(1003) // 'cantMakePayments'

エラーコードの比較

重要： error.adaptyCodeは数値なので、数値コードと直接比較してください：

// Option 1: Use ErrorCodeName constant (recommended) ✅
if (error.adaptyCode === ErrorCodeName.cantMakePayments) {
  console.log('Cannot make payments');
}

// Option 2: Compare with numeric literal ✅
if (error.adaptyCode === 1003) {
  console.log('Cannot make payments');
}

// NOT like this ❌ - compares number to string and will never match
if (error.adaptyCode === ErrorCode[1003]) {
}

グローバルエラーハンドラー

すべての Adapty エラーをキャッチするグローバルエラーハンドラーを設定できます。


// Set up global error handler
AdaptyError.onError = (error: AdaptyError) => {
  console.error('Global Adapty error:', {
    code: error.adaptyCode,
    message: error.localizedDescription,
    detail: error.detail
  });
  
  // Handle specific error types globally
  if (error.adaptyCode === ErrorCodeName.notActivated) {
    // SDK not activated - maybe retry activation
    console.log('SDK not activated, attempting to reactivate...');
  }
};

よくあるエラー処理パターン

購入エラーの処理


async function handlePurchase(product: AdaptyPaywallProduct) {
  try {
    const result = await adapty.makePurchase({ product });
    
    if (result.type === 'success') {
      console.log('Purchase successful:', result.profile);
    } else if (result.type === 'user_cancelled') {
      console.log('User cancelled the purchase');
    } else if (result.type === 'pending') {
      console.log('Purchase is pending');
    }
  } catch (error) {
    if (error instanceof AdaptyError) {
      switch (error.adaptyCode) {
        case ErrorCodeName.cantMakePayments:
          console.log('In-app purchases not allowed');
          break;
        case ErrorCodeName.productPurchaseFailed:
          console.log('Purchase failed:', error.detail);
          break;
        default:
          console.error('Purchase error:', error.localizedDescription);
      }
    }
  }
}

ネットワークエラーへの対処


async function fetchFlow(placementId: string) {
  try {
    const flow = await adapty.getFlow({ placementId });
    return flow;
  } catch (error) {
    if (error instanceof AdaptyError) {
      switch (error.adaptyCode) {
        case ErrorCodeName.networkFailed:
          console.log('Network error, retrying...');
          // Implement retry logic
          break;
        case ErrorCodeName.serverError:
          console.log('Server error:', error.detail);
          break;
        case ErrorCodeName.notActivated:
          console.log('SDK not activated');
          break;
        default:
          console.error('Paywall fetch error:', error.localizedDescription);
      }
    }
    throw error;
  }
}

システム StoreKit コード

エラー	コード	説明
unknown	0	不明または予期しないエラーが発生したことを示します。
clientInvalid	1	クライアントが試みた操作を実行する権限がないことを示します。
paymentCancelled	2	ユーザーが支払いリクエストをキャンセルしたことを示します。対応は不要ですが、ビジネスロジックの観点から、割引を提供したり後でリマインドしたりすることができます。
paymentInvalid	3	支払いパラメーターのいずれかがストアで認識されなかったことを示します。
paymentNotAllowed	4	ユーザーが支払いを承認する権限を持っていないことを示します。考えられる原因： - ユーザーの国では支払いがサポートされていない。 - ユーザーが未成年である。
storeProductNotAvailable	5	リクエストされたプロダクトが App Store に存在しないことを示します。該当の国でプロダクトが利用可能かどうかを確認してください。
cloudServicePermissionDenied	6	ユーザーがクラウドサービス情報へのアクセスを許可していないことを示します。
cloudServiceNetworkConnectionFailed	7	デバイスがネットワークに接続できなかったことを示します。
cloudServiceRevoked	8	ユーザーがこのクラウドサービスの使用許可を取り消したことを示します。
privacyAcknowledgementRequired	9	ユーザーがストアのプライバシーポリシーにまだ同意していないことを示します。
unauthorizedRequestData	10	リクエストが正しく構築されていないことを示します。
invalidOfferIdentifier	11	オファー識別子が無効です。考えられる原因： - その識別子のオファーが App Store に設定されていない。 - オファーが取り消されている。 - オファー ID の入力ミスがある。
invalidSignature	12	支払い割引のシグネチャが無効であることを示します。In-app purchase Key ID フィールドへの入力と In-App Purchase Private Key ファイルのアップロードが完了しているか確認してください。詳細は App Store インテグレーションの設定をご覧ください。
missingOfferParams	13	Adapty インテグレーションまたはオファーに問題があることを示します。設定方法については App Store インテグレーションの設定およびオファーをご覧ください。
invalidOfferPrice	14	ストアで指定した価格が無効になったことを示します。オファーは常に割引価格を設定する必要があります。

カスタム Android コード

エラー	コード	説明
adaptyNotInitialized	20	`activate` メソッドを使用して Adapty SDK を正しく設定する必要があります。設定方法は Adapty SDK のインストールと設定をご覧ください。
productNotFound	22	購入対象のプロダクトがストアで利用できないことを示します。
currentSubscriptionToUpdateNotFoundInHistory	24	更新対象の元のサブスクリプションが見つかりません。
billingServiceTimeout	97	Google Play が応答する前にリクエストが最大タイムアウトに達したことを示します。Play Billing Library の呼び出しによってリクエストされた操作の実行に遅延が発生した場合などに起こります。
featureNotSupported	98	リクエストされた機能が現在のデバイスの Play Store でサポートされていません。
billingServiceDisconnected	99	クライアントアプリと Google Play Store サービス間の `BillingClient` 経由の接続が切断されたことを示す致命的なエラーです。
billingServiceUnavailable	102	Google Play Billing サービスが現在利用できないことを示す一時的なエラーです。ほとんどの場合、クライアントデバイスと Google Play Billing サービス間のどこかでネットワーク接続の問題が発生しています。
billingUnavailable	103	購入プロセス中にユーザーの請求エラーが発生したことを示します。発生する例： 1. ユーザーのデバイス上の Play Store アプリが古い。 2. ユーザーがサポートされていない国にいる。 3. ユーザーが企業ユーザーであり、企業の管理者がユーザーの購入を無効にしている。 4. Google Play がユーザーの支払い方法に請求できない（例：クレジットカードの有効期限切れ）。 5. ユーザーが Play Store アプリにログインしていない。
developerError	105	API の不正な使用を示す致命的なエラーです。
billingError	106	Google Play 自体の内部問題を示す致命的なエラーです。
itemAlreadyOwned	107	消耗型アイテムがすでに購入済みです。
itemNotOwned	108	アイテムに対するリクエストされた操作が失敗したことを示します。
billingNetworkError	112	デバイスと Play システム間のネットワーク接続に問題が発生したことを示します。

カスタム StoreKit コード

エラー	コード	説明
noProductIDsFound	1000	ペイウォール内のどのプロダクトもストアで利用できないことを示します。このエラーが発生した場合は、以下の手順で解決してください： 1. すべてのプロダクトが Adapty ダッシュボードに追加されているか確認する。 2. アプリの Bundle ID が Apple Connect のものと一致しているか確認する。 3. アプリストアのプロダクト識別子がダッシュボードに追加した識別子と一致しているか確認する。なお、Bundle ID がすでにストアに含まれている場合を除き、識別子に Bundle ID を含めないでください。 4. Apple の税務設定でアプリの有料ステータスがアクティブになっているか確認する。税務情報が最新で証明書が有効であることを確認する。 5. アプリに銀行口座が紐付けられており、収益化が可能な状態かどうかを確認する。 6. プロダクトがすべての地域で利用可能かどうかを確認する。また、プロダクトが “Ready to Submit” の状態になっているか確認する。
productRequestFailed	1002	現時点で利用可能なプロダクトを取得できません。考えられる原因： - キャッシュがまだ作成されておらず、かつインターネット接続もない。
cantMakePayments	1003	このデバイスではアプリ内課金が許可されていません。
noPurchasesToRestore	1004	Google Play が復元対象の購入を見つけられなかったことを示します。
cantReadReceipt	1005	デバイスに有効なレシートがありません。サンドボックステスト中に発生することがあります。対応は不要ですが、ビジネスロジックの観点から、割引を提供したり後でリマインドしたりすることができます。
productPurchaseFailed	1006	プロダクトの購入に失敗しました。これは基礎となる StoreKit エラーをラップしています。実際の原因を確認するには、ラップされたエラーを参照するか、詳細ログを有効にしてコンソールで確認してください。ラップされたエラーは通常、上記の表にある StoreKit コード 0〜14 のいずれかで、最も多いのは `paymentCancelled`、`paymentInvalid`、`paymentNotAllowed`、または `invalidOfferPrice` です。特定の原因が特定できない場合は、新しいサンドボックスプロファイルで試してみてください。それでも失敗する場合は Apple サポートにお問い合わせください。
refreshReceiptFailed	1010	レシートを受信できなかったことを示します。StoreKit 1 にのみ適用されます。
receiveRestoredTransactionsFailed	1011	購入の復元に失敗しました。

カスタムネットワークコード

エラー	コード	説明
notActivated	2002	`activate` メソッドを使用して Adapty SDK を正しく設定する必要があります。設定方法は Adapty SDK のインストールと設定をご覧ください。
badRequest	2003	不正なリクエストです。
serverError	2004	サーバーエラーです。
networkFailed	2005	ネットワークリクエストが失敗しました。
decodingFailed	2006	レスポンスのデコードに失敗したことを示します。
encodingFailed	2009	リクエストのエンコードに失敗したことを示します。
analyticsDisabled	3000	アナリティクスをオプトアウトしているため、アナリティクスイベントを処理できません。詳細はアナリティクスインテグレーションをご覧ください。
wrongParam	3001	パラメーターの一部が正しくないことを示します（空白にできない箇所が空白になっている、型が間違っているなど）。
activateOnceError	3005	`.activate` メソッドを複数回呼び出すことはできません。
profileWasChanged	3006	操作中にユーザープロファイルが変更されました。
unsupportedData	3007	データ形式が SDK でサポートされていないことを示します。
persistingDataError	3100	データの保存中にエラーが発生しました。
fetchTimeoutError	3101	設定された制限時間内にペイウォールを取得できなかったことを示します。この状況を避けるには、ローカルフォールバックを設定してください。
operationInterrupted	9000	この操作はシステムによって中断されました。