Что спрашивает анкета
Три коротких шага, всё — про ваш бизнес, без технического жаргона:
- Что вы продаёте. Пара предложений: что это, кто покупает и зачем. Плюс примерный средний чек (до 5 000 ₸ / 5 000–25 000 / 25 000–100 000 / больше 100 000 ₸).
- Где вы продаёте. Ссылка на витрину — сайт, Telegram-бот или канал, Instagram и т.п.; откуда приходят клиенты; 1–3 скриншота (витрина, прайс, переписка с заказом) — jpg или png, до 6 МБ каждый. Файл больше 6 МБ →
413 file_too_large, другой формат →422 invalid_file_type. Подходит обычный скриншот экрана; длинная склейка нескольких страниц в один узкий файл не принимается (422 image_rejected) — приложите её частями. - Проверьте и отправьте. Подтвердите галочкой, что не торгуете запрещённым (азартные игры, крипта/форекс, оружие, взрослый контент и подобное), и отправьте.
Черновик сохраняется автоматически — можно закрыть и вернуться позже.
Вам прислали ссылку на анкету
Если вы работаете через платформу-партнёра (например, вашу учётную систему или CRM), кабинета в ApiPay у вас может не быть вовсе — тогда анкета приходит ссылкой от платформы. Это тот же самый опросник и та же проверка, отличий два:
- регистрация и вход не нужны — страница открывается прямо по ссылке, на ней видно только название вашей организации;
- ссылка одноразовая на выдачу, но открывать её можно сколько угодно раз до истечения срока. Потеряли — попросите платформу выдать новую; после этого старая перестанет работать.
Ссылка личная: она открывает анкету вашей организации без входа и пароля — не пересылайте её посторонним. Ушла не туда — попросите платформу выдать новую, старая сразу перестанет работать.
Если анкету вернут на доработку, исправляйте её по той же ссылке: заводить вторую не нужно. Ссылка перестала открываться и показывает, что недействительна, — значит истёк срок либо платформа уже выдала новую.
Статусы анкеты
Статус читается машинно: GET /api/users/me → organizations[].kyc_status (required → submitted → approved / needs_changes / blocked); при needs_changes рядом приходит kyc_comment — комментарий модератора дословно.
- Не заполнена / на доработке — анкету можно заполнить или поправить по комментарию. Лимит 1 счёт/сутки действует.
- На проверке — анкету смотрит специалист, обычно отвечаем за 1 рабочий день. Лимит ещё действует.
- Одобрена — лимит снят.
- Отказ (blocked) — приём платежей закрыт: создание счёта возвращает
403 kyc_rejected. Статус терминальный, повторно анкету подать нельзя. Считаете это ошибкой — напишите в поддержку. - Пришли по ссылке от платформы? Статуса в кабинете вы не увидите — о решении сообщает та платформа, которая прислала ссылку: комментарий модератора приходит ей дословно. Если ответа долго нет — спросите её.
Что делать при лимите «1 счёт в сутки»
Если при создании второго реального счёта за сутки пришёл 429 kyc_daily_limit_reached:
- Не повторяйте запрос — в теле ответа
meta{limit, reset_at, kyc_status}, в заголовкеRetry-Afterсекунды до сброса (окно суток по времени Asia/Almaty). В лимит идут все реальные счета организации: выставленные из кабинета, созданные по API-ключу, счета по QR и автосписания подписок; в/invoices/bulkотказ приходит по позиции. Не считаются счета песочницы и Kaspi-продажи, подтянутые синхронизацией. - Заполните анкету на
/business-profile, если ещё не заполнили, — это снимает лимит после одобрения. Пока ждёте, продолжайте отладку в песочнице: там счетов можно создавать сколько угодно. - Уже одобрены, а лимит всё равно? Проверьте, что счёт создаётся в рабочем режиме той же организации, для которой одобрена анкета. Не помогает — напишите в поддержку.
Полная таблица лимитов — в статье «Лимиты и квоты ApiPay».
Требования к вебхуку в рабочем режиме
Пока организация не одобрена, рабочий вебхук должен быть на реальном домене: IP-адрес вместо домена → 422 webhook_url_requires_domain, туннель (ngrok и подобные) → 422 webhook_url_tunnel_forbidden. В песочнице туннель для локального теста допустим. Детали — «Настройка вебхуков».