Устранение ошибки «недостаточно кредитов»
Почти всегда причина - платная функция в рабочем процессе, который вы считали бесплатным: white label, AML, NFC или активная liveness-проверка. Как найти виновника и не допустить повторения.
В девяти случаях из десяти дело не в исчерпанном бесплатном лимите. Дело в платной функции в рабочем процессе - чаще всего это white label ($0.20), AML ($0.20), NFC ($0.15) или активная liveness-проверка ($0.15). Прежде чем пополнять баланс, откройте рабочий процесс и посмотрите, что в нем включено.
Если запрос на верификацию завершается ошибкой "You don't have enough credits to perform this request", баланс вашей организации не покрывает функцию, которую пытается выполнить рабочий процесс.
API сообщает о том же условии кодом ошибки insufficient_credits при создании сессии. Два уточнения, которые экономят тикеты: в рабочем процессе активные методы liveness называются 3D Flash и 3D-действие и Flash, и бесплатен только Пассивный liveness; а проверка по базам данных и проверка телефона дополнительно требуют первого пополнения, прежде чем вообще выполняться (приветственные 10 $ не считаются). См. проверку по базам данных.
#Сначала проверьте рабочий процесс, потом баланс
Первый порыв - посмотреть на свое использование. Сначала посмотрите на рабочий процесс, потому что бесплатный тариф покрывает только эти четыре функции, у каждой из которых свой лимит в 500 бесплатных проверок в месяц:
- Проверка документа
- Пассивная liveness-проверка
- Face match 1:1
- Анализ устройства и IP
Любой другой модуль тарифицируется с первой же проверки, при любом объеме. Обычные виновники, в порядке того, как они реально всплывают:
| Функция | Цена | Почему это удивляет |
|---|---|---|
| White label / кастомный брендинг | $0.20 за верификацию | Это настройка внешнего вида, поэтому она не ощущается как «проверка» |
| AML-проверка | $0.20 | Часто добавляется в шаблон «бесплатного KYC» незаметно |
| NFC | $0.15 | Тарифицируется отдельно от проверки документа |
| Активная liveness-проверка | $0.15 | Переход с пассивной на активную выводит за пределы бесплатного тарифа |
| Оценка возраста | $0.10 | Бесплатная проверка документа ее не покрывает |
| Анкета | $0.10 | Ощущается как форма, а не как проверка |
| Верификация телефона | от $0.03 + комиссия оператора | Комиссия оператора зависит от направления |
| Верификация email | $0.03 | |
| Подтверждение адреса | $0.20 | |
| Database validation | Зависит от страны | |
| Верификация бизнеса (KYB) | $2.00 |
White label - самая частая причина. Рабочий процесс с включенным кастомным брендингом стоит $0.20 за каждую завершенную верификацию сверх стоимости остальных модулей - поэтому флоу, который вы настроили как бесплатный KYC, становится платным в тот момент, когда вы его брендируете. См. настройка брендинга.
#Как это исправить
- Откройте рабочий процесс, который использует упавшая сессия
Не любой рабочий процесс - именно тот, с чьим ID была создана сессия. В разделе Workflows сверьте каждую включенную функцию с таблицей выше.
- Проверьте и вкладку Options
White label включается на уровне рабочего процесса в разделе Settings → Options → Include custom style, а не в списке шагов, поэтому его легко пропустить при аудите шагов.
- Проверьте баланс
Settings → Billing показывает текущий баланс. Если он отрицательный, все платные операции останавливаются - включая ваши бесплатные проверки - пока баланс не вернется выше нуля.
- Либо отключите платную функцию, либо пополните баланс
Если платная функция вам не нужна, отключите ее и опубликуйте изменения заново. Если нужна - пополните баланс, минимальное пополнение $50. См. пополнения, счета и способы оплаты.
- Пополнение баланса сразу устраняет ошибку.
- Убедитесь, что пополнение действительно прошло, прежде чем считать, что баланс некорректен.
#Другие причины, которые стоит исключить
-
Отрицательный баланс. Как только баланс уходит ниже нуля, бесплатные проверки тоже останавливаются. Это тот случай, когда ошибка на самом деле не связана с платной функцией.
-
Ключ не от того приложения. Баланс общий для организации, но если вы вызываете API с ключом приложения, чей рабочий процесс отличается от того, что вы проверяли, вы смотрите не на ту конфигурацию. См. организации, приложения и окружения.
-
Standalone-вызов API, а не сессия рабочего процесса. Standalone-вызовы тарифицируются за каждый вызов без бесплатного лимита, даже для функций, бесплатных внутри рабочего процесса.
-
Вы действительно израсходовали лимит в 500 проверок по какой-то функции. Проверьте Analytics на объем за месяц по каждой функции, прежде чем предполагать это - и помните, что у каждой из четырех функций свой отдельный лимит, поэтому при низком объеме это наименее вероятное объяснение.
-
Проверка телефона или проверка по базам данных до какого-либо пополнения. Обе остаются неактивными, пока ваша организация не сделает первое реальное пополнение; приветственные кредиты их не разблокируют. См. пополнения, счета и способы оплаты.
-
Песочница, которая работала, и боевое приложение, которое не работает. Песочница никогда ничего не списывает, поэтому не может выявить платную функцию. Первая боевая сессия - это момент, когда проявляется реальная цена рабочего процесса.
#Как не допустить повторения
- Включите auto-refill в разделе Settings → Billing, чтобы баланс пополнялся автоматически при падении ниже выбранного вами порога.
- Тестируйте в sandbox, где ничего не тарифицируется и проверка баланса полностью отключена. См. тестирование в sandbox.
- Разделяйте тестовое и live-приложения, чтобы эксперимент не мог истощить баланс, от которого зависит ваш продакшен-трафик.
#Ограничение расходов
Если вам нужен жесткий потолок, чтобы аккаунт не мог уйти в минус во время тестирования, это вопрос настройки на уровне аккаунта, а не рабочего процесса - спросите поддержку, что доступно для вашей организации. А пока практическое решение - продолжать тестировать в sandbox-приложении, где тратить попросту нечего.
#Если пополнения недоступны для самостоятельной оплаты
Организации на годовом тарифе не могут покупать кредиты через самостоятельный флоу пополнения - обратитесь к своему аккаунт-менеджеру. Попытка самостоятельного пополнения сообщит вам об этом, а не завершится молча неудачей.
#Если ваш баланс выглядит неправильно
Если ваш баланс, счета или история верификаций внезапно кажутся пропавшими или некорректными, это почти всегда временная проблема платформы, а не потеря данных. Обратитесь в поддержку, а не пытайтесь исправить это сами, и укажите ID вашей организации.