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

ほとんどの場合、無料だと思っていたワークフローに含まれる有料機能が原因です。ホワイトラベル、AML、NFC、アクティブライブネスなどです。原因の特定方法と再発防止策を説明します。

執筆: Didit サポート · 更新日: 2026年9月15日

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

セッション作成時、APIは同じ状態をエラーコードinsufficient_creditsとして報告します。チケットを減らす2つの補足：ワークフローでは、アクティブなライブネス方式は3Dフラッシュと3Dアクション＆フラッシュと呼ばれ、無料なのはパッシブライブネスだけです。また、データベース検証と電話番号検証は実行前に初回チャージが必要です（ウェルカムクレジットの10ドルはカウントされません）。データベース検証を参照してください。

#残高を見る前にワークフローを確認する

まず利用量を見たくなりますが、先にワークフローを確認してください。無料枠が対象とするのは次の4つの機能だけで、それぞれに月500回分の無料枠があります。

• ID verification
• Passive liveness
• Face match 1:1
• Device and IP analysis

それ以外のモジュールはすべて、利用量にかかわらず最初のチェックから課金されます。 実際によく見られる原因を、発生頻度の高い順に挙げます。

#解消方法

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

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

2. Optionsタブも確認する

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

3. 残高を確認する

   Settings → Billingで現在の残高を確認できます。マイナスの場合、プラスに戻るまで無料枠のチェックを含むすべての課金対象処理が停止します。

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

   その有料機能が不要であれば無効化して再公開してください。必要であれば資金を追加してください。最低トップアップ額は$50です。トップアップ、請求書、支払い方法をご覧ください。

12

1. クレジットを追加すると、エラーは即座に解消します。
2. 残高がおかしいと決めつける前に、トップアップが実際に反映されているか確認してください。

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

• 残高がマイナス。 残高がゼロを下回ると、無料枠のチェックも停止します。これは、原因が本当に有料機能ではないケースです。

• アプリケーションのキーの取り違え。 残高は組織単位ですが、監査したワークフローとは異なるアプリケーションのキーで呼び出している場合、確認しているのは別の設定です。組織、アプリケーション、環境をご覧ください。

• ワークフローセッションではなくスタンドアロンのAPI呼び出し。 スタンドアロン呼び出しは無料枠なしで呼び出しごとに課金されます。ワークフロー内であれば無料になる機能でも同様です。

• 本当にその機能の500回を使い切った。 これを疑う前に、その月の機能別の利用量をAnalyticsで確認してください。4つの機能それぞれに独自の割り当てがあるため、利用量が少ない場合はこれが原因である可能性は最も低くなります。

• 一度もチャージする前の電話番号検証やデータベース検証。 どちらも組織が最初の実際のチャージを行うまで無効のままです。ウェルカムクレジットでは解除されません。チャージ、請求書、支払い方法を参照してください。

• サンドボックスでは動いたのに本番アプリケーションでは動かない。 サンドボックスは何も課金しないため、有料機能を明らかにできません。ワークフローの本当の料金が現れるのは最初の本番セッションです。

#再発を防ぐ

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

#支出に上限を設ける

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

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

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

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

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