Все статьи

getNumber, getStatus, setStatus 3/6/8: где в цикле активации теряются деньги

Бот взял номер, через 30 секунд не увидел SMS, отправил setStatus 8 и ушёл за следующим. Сервер отмену не принял, но ответ никто не прочитал. Позже по первому номеру пришёл код: заказ оплачен, а код так и не использован. Ниже цикл активации через API по шагам и ветки, где интеграция платит за ненужные ей коды.

Цикл по шагам

  1. getNumber. Бот берёт номер под сервис и страну, сумма заказа резервируется на балансе, в ответе приходит id активации. Сохраните id в постоянное хранилище до того, как бот введёт номер в сервисе: если процесс упадёт, без id заказ не отменить и код не забрать.
  2. getStatus. Бот опрашивает статус и ждёт код. Сколько ждать, задаёт каталог для каждого сервиса, сейчас это час.
  3. setStatus 3. Нужен ещё один код на тот же номер: первый не подошёл или сервис просит подтвердить повторно. После 3 бот снова опрашивает getStatus.
  4. setStatus 6. Код использован, заказ завершён.
  5. setStatus 8. Отмена. Её принимают, пока код не пришёл, и не раньше чем через минуту после покупки.

Если бот ничего не делает и код не пришёл, по истечении срока резерв возвращается на баланс сам. Отсюда главное правило интеграции: отмена активации через setStatus 8 даёт возврат только до прихода кода. После получения SMS услуга считается оказанной, и деньги за такой заказ не возвращаются. Все возвраты идут на внутренний баланс, не на кошелёк.

Где теряются деньги

Отмена в первую минуту. Это сценарий из начала. Читайте ответ на каждый setStatus 8. Если отмена не прошла из-за минуты, продолжайте опрашивать getStatus и повторите отмену, когда минута с покупки истечёт.

Гонка опроса и отмены. getStatus вернул «ждём», бот отправил 8, а код пришёл между двумя запросами. Отмена уже не пройдёт. Сделайте ещё один getStatus и используйте код: заказ всё равно оплачен.

Отмена после кода из-за сорванной регистрации. Сервис отклонил аккаунт, разработчик ставит 8 и ждёт денег. Код доставлен, значит услуга оказана, а получение SMS не гарантирует успешную регистрацию в стороннем сервисе. Закрывайте такие заказы статусом 6 и считайте их в отчёте отдельно от отмен.

Брошенный номер. Бот уходит к следующему номеру без отмены, часто из-за общего таймаута на все сервисы. Если таймаут короче срока сервиса, код может прийти, когда бот уже не ждёт, и заказ оплачен впустую. Берите таймаут из срока конкретного сервиса, а номер, который больше не нужен, закрывайте статусом 8 явно.

Новый номер вместо статуса 3. Первый код не подошёл, и бот покупает другой номер. Новый getNumber создаёт отдельный заказ со своим резервом, а регистрацию в сервисе приходится начинать заново. Запрашивайте повторный код статусом 3 на том же номере и проверяйте, что getStatus вернул новый код, а не прежний.

Незакрытый успех. Код введён, а 6 не отправлен. Заказ остаётся открытым до конца срока, и по логу уже не отличить отработанные номера от ждущих код. Отправляйте 6, как только сервис принял код.

Переезд с другого сервиса. Если бот перешёл к нам сменой базового URL, ветки статусов писались под правила прежней площадки. Проверьте минутную задержку перед отменой и таймауты по сроку из нашего каталога.

Опрос, ключи и softId

Лимит API: 600 запросов в минуту на ключ, то есть десять в секунду на все открытые заказы вместе. Плотный цикл getStatus упирается в него быстро. Опаснее всего, когда отказ по лимиту код принимает за «кода нет» и отменяет или бросает номер. Опрашивайте каждый заказ с паузой в несколько секунд, а ответ об ограничении обрабатывайте отдельной веткой: подождать и повторить.

По ключу API покупают за ваш баланс. Выпускайте отдельный именованный ключ под каждого бота или окружение: по дате последнего использования в кабинете видно, какой ключ лишний, и его можно отозвать.

Владельцам софта из партнёрской программы: проверьте, что softId уходит в каждом getNumber. Без него покупка не привяжется к вашему software_id, и 5% с активации пользователя не начислятся. Если по заказу прошёл возврат, отчисление по нему списывается.

Что проверить сегодня

Откройте справочник API в кабинете и сверьте с ним обработку каждого статуса, в первую очередь ответ на 8 и таймауты по сроку сервиса. Затем в ленте операций выберите период и сопоставьте возвраты с логом бота: каждый заказ, отменённый или истёкший без кода, должен вернуться на баланс. Если в логе отмена, а в ленте по этому заказу только оплата, найдите номер в истории заказов и проверьте, когда бот отправил 8: в первую минуту или уже после кода.

Первый номер через минуту

Минута на регистрацию, пара минут на пополнение, код приходит за 20 секунд.

Купить номер
Без абонентской платыОтмена с возвратом в первый час