# 「クレジット不足」エラーの解消

Source: https://help.didit.me/ja/billing-credits/not-enough-credits
Updated: 2026-10-31

プランクレジットと残高を使い切ったか、ワークフローにFreeプランのクレジットで支払えないチェックが含まれています。原因を特定し、再発を防ぎます。

当月のプランクレジットとトップアップ残高では、ワークフロー内のチェックの費用をまかなえていません。ワークフローに**ホワイトラベル**（$0.20）、AML（$0.20）、NFC（$0.15）、アクティブライブネス（$0.15）が含まれていると、Freeプランの月$10は想定より早くなくなります。トップアップする前に、まずワークフローを開いて何が有効になっているかを確認してください。

検証リクエストが`"You don't have enough credits to perform this request"`で失敗する場合、組織の残高が、ワークフローが実行しようとしている機能の費用をまかなえていません。

セッション作成時、APIは同じ状態をエラーコード`insufficient_credits`として報告します。ワークフローに電話番号確認やデータベース検証が含まれている場合など、**「クレジット不足」エラー（502になることもあります）**として現れることもあります。これらはFreeプランのクレジットでは支払われません。ワークフローでは、アクティブなライブネス方式は**3Dフラッシュ**と**3Dアクション＆フラッシュ**と呼ばれ、**パッシブライブネス**は$0.10です。データベース検証と電話番号検証は実行前に**初回チャージ**が必要です（Freeプランのクレジットはカウントされません）。[データベース検証](https://help.didit.me/ja/documents-coverage/database-validation)を参照してください。
## 残高を見る前にワークフローを確認する

まず利用量を見たくなりますが、先に**ワークフロー**を確認してください。有効なモジュールはすべて月$10のクレジット（Freeプラン）と、その次に残高から支払われ、基本の4つ（ID verification、passive liveness、face match 1:1、device and IP analysis、合計$0.33）よりずっと高額なモジュールもあります。実際によく見られる原因を、発生頻度の高い順に挙げます。

| 機能 | 料金 | 見落とされやすい理由 |
|---|---|---|
| **ホワイトラベル/カスタムブランディング** | 検証1件あたり$0.20 | 見た目の設定であり、「チェック」という感覚がない |
| **AMLスクリーニング** | $0.20 | 基本のKYCテンプレートに気づかず追加されていることが多い |
| **NFC** | $0.15 | ID verificationとは別に課金される |
| **アクティブライブネス** | $0.15 | パッシブからアクティブに切り替えると料金が上がる。**パッシブライブネス**は$0.10 |
| **年齢推定** | $0.10 | ID verificationとは別料金 |
| **アンケート** | $0.10 | フォームのように感じられ、チェックだと意識されない |
| **電話認証** | $0.03からキャリア手数料が加算 | キャリア手数料は宛先によって異なる |
| **メール認証** | $0.03 | |
| **住所証明** | $0.20 | |
| **データベース検証** | 国によって異なる | **初回チャージ**も必要で、実行前にFreeプランのクレジットはカウントされません。[データベース検証](https://help.didit.me/ja/documents-coverage/database-validation)を参照 |
| **企業検証（KYB）** | 国と登記情報の取得レベルによって異なる | |

> **Warning:** **ホワイトラベルが最も多い原因です。** カスタムブランディングを有効にしたワークフローは、各モジュールの料金**に加えて**、完了した検証1件あたり$0.20かかります。通常のKYCフローとして構築したはずが、ブランド設定を加えた瞬間に費用が約60%増えます。[ブランディングとエクスペリエンスのカスタマイズ](https://help.didit.me/ja/workflows/customize-branding-and-experience)をご覧ください。

## 解消方法

1. **失敗しているセッションが使うワークフローを開く**

   どのワークフローでもよいわけではなく、そのセッションが作成された際のワークフローIDのものです。**Workflows**で、有効になっている機能を上の表と1つずつ照合してください。

2. **Optionsタブも確認する**

   ホワイトラベルは、ステップの一覧ではなく**Settings → Options → Include custom style**でワークフローごとに有効化されるため、ステップを監査しただけでは見落としがちです。

3. **残高を確認する**

   **Settings → Billing**で現在の残高を確認できます。当月のクレジットを使い切り、残高がゼロまたはマイナスの場合、プラスに戻るまですべての課金対象処理が停止します。

4. **有料機能を外すか、トップアップする**

   その有料機能が不要であれば無効化して再公開してください。必要であれば資金を追加してください。最低トップアップ額は$50です。[トップアップ、請求書、支払い方法](https://help.didit.me/ja/billing-credits/top-ups-invoices-and-payments)をご覧ください。

![残高とトップアップボタンを表示する請求画面](https://help.didit.me/screenshots/billing-credits-light.webp)

*残高を確認する前に、まずワークフローの有料機能を確認してください。*

## その他に確認すべき原因

- **残高がマイナス。** 残高がゼロを下回り、月次クレジットも使い切ると、本番のチェックが停止します。これは、原因が特定のモジュールではないケースです。
- **アプリケーションのキーの取り違え。** 残高は組織単位ですが、監査したワークフローとは異なるアプリケーションのキーで呼び出している場合、確認しているのは別の設定です。[組織、アプリケーション、環境](https://help.didit.me/ja/account-organization/organizations-and-applications)をご覧ください。
- **ワークフローセッションではなくスタンドアロンのAPI呼び出し。** スタンドアロン呼び出しは定価で呼び出しごとに課金され、同じクレジットと残高を使うため、想定より早く使い切ることがあります。
- **本当にその月の$10を使い切った。** これを疑う前に、その月の機能別の利用量をAnalyticsで、各チェックの請求額をUsageで確認してください。クレジットは毎月1日にリセットされます。

- **一度もチャージする前の電話番号検証やデータベース検証。** どちらも組織が最初の実際のチャージを行うまで無効のままです。Freeプランのクレジットでは解除されません。[チャージ、請求書、支払い方法](https://help.didit.me/ja/billing-credits/top-ups-invoices-and-payments)を参照してください。
- **サンドボックスでは動いたのに本番アプリケーションでは動かない。** サンドボックスは何も課金しないため、有料機能を明らかにできません。ワークフローの本当の料金が現れるのは最初の本番セッションです。

## 再発を防ぐ

- **Settings → Billing**で**自動リフィル**をオンにし、選んだ閾値を下回ったら自動的に残高がトップアップされるようにしてください。
- **サンドボックスでテストする。** サンドボックスでは何も課金されず、残高チェック自体が完全にバイパスされます。[サンドボックスでのテスト](https://help.didit.me/ja/getting-started/sandbox-and-testing)をご覧ください。
- **テスト用と本番用のアプリケーションを分ける。** そうすれば、実験が本番トラフィックの残高を消費することはありません。

## 支出に上限を設ける

テスト中にアカウントがマイナスにならないよう厳密な上限を設けたい場合、それはワークフロー設定ではなくアカウントレベルの制御であり、組織で利用可能な内容についてはサポートに確認してください。当面の実用的な方法としては、支出のしようがないサンドボックスアプリケーションでテストを続けることです。

## トップアップがセルフサーブでない場合

年間契約の組織は、セルフサーブのトップアップフローでクレジットを購入できません。代わりにアカウントマネージャーに連絡してください。セルフサーブでの操作は、黙って失敗するのではなく、その旨を案内します。

## 残高がおかしく見える場合

残高、請求書、検証履歴が急に見当たらなくなったり不正確に見えたりする場合、それはほぼ常に一時的なプラットフォームの問題であり、データが失われたわけではありません。自分で修正しようとせず、組織IDを添えてサポートに連絡してください。