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

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

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

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

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

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

#解消方法

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

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

2. Optionsタブも確認する

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

3. 残高を確認する

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

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

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

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

• 残高がマイナス。 残高がゼロを下回り、月次クレジットも使い切ると、本番のチェックが停止します。これは、原因が特定のモジュールではないケースです。

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

• ワークフローセッションではなくスタンドアロンのAPI呼び出し。 スタンドアロン呼び出しは定価で呼び出しごとに課金され、同じクレジットと残高を使うため、想定より早く使い切ることがあります。

• 本当にその月の$10を使い切った。 これを疑う前に、その月の機能別の利用量をAnalyticsで、各チェックの請求額をUsageで確認してください。クレジットは毎月1日にリセットされます。

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

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

#再発を防ぐ

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

#支出に上限を設ける

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

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

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

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

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