Чем тестовый период отличается от песочницы?
- Песочница (sandbox) — учебный режим: счета в Kaspi не передаются, оплату вы имитируете сами. Кассир для неё не нужен, она бесплатна без ограничения срока, лимит — 1000 тестовых счетов на организацию (
400 sandbox_invoice_limit). Подробно — «Песочница и рабочий режим». - Тестовый период (триал) — 3 бесплатных дня рабочего режима: счета уходят в Kaspi по-настоящему, покупатели получают push и платят, деньги зачисляются на ваш Kaspi-счёт. Это полноценная работа сервиса, просто бесплатная.
Правильный порядок знакомства: сначала отладьте интеграцию в песочнице (бесплатно и не спеша), потом подключите кассира и потратьте 3 тестовых дня на проверку боевых оплат.
Когда начинаются 3 дня и почему «сами»?
Триал активируется автоматически в момент подключения кассира способом 1: кабинет apipay.kz → Настройки → «Авторизация Kaspi». Подключили кассира — с этой секунды пошли 3 дня. Поэтому регистрация на apipay.kz таймер не запускает, и работа в песочнице его не тратит: он стартует только вместе с реальной возможностью принимать оплату.
Какой номер годится в кассиры — «Требования к номеру кассира».
Что можно делать в тестовые 3 дня?
Всё то же, что на платном тарифе: выставлять счета по номеру телефона и QR-счета, получать вебхуки, делать возвраты, смотреть статистику. Деньги от покупателей — сразу на ваш Kaspi-счёт, как обычно (ApiPay к деньгам доступа не имеет).
Ограничений два, и первым срабатывает более жёсткое.
Первое — анкета о бизнесе. Пока она не одобрена, организация выставляет 1 реальный счёт в сутки — «Анкета о бизнесе и лимит».
Второе — потолок пробного тарифа: 50 счетов в сутки. Он считает только счета, созданные по API-ключу; 51-й вернёт 429 trial_daily_limit («Достигнут дневной лимит счетов на пробном тарифе») с заголовком Retry-After.
То есть до одобрения анкеты боевой счёт в сутки будет один, а не пятьдесят: анкету на /business-profile заполняйте до подключения кассира, а нагрузочные прогоны держите в песочнице — там лимита нет.
Что происходит после трёх дней?
Если тариф не оплачен, ровно с момента окончания теста (отсрочки нет) все платные операции отвечают 403 tariff_inactive — в теле expires_at и reason (expired | cancelled | none).
Закрыты: создание счетов (обычных, массовых и по QR), отмена и возврат, фискальные чеки, запись в каталог, создание и изменение подписок, проверка клиента и запуск синхронизации — последние две закрыты даже методом GET. В массовой загрузке 403 отбивает весь запрос целиком, а не отдельные позиции.
Работают: чтение (все остальные GET — история, статусы, каталог), проверка статусов счетов, оплата тарифа, управление ключами и менеджерами, подключение и переподключение кассира, постановка подписки на паузу и её отмена.
Данные никуда не деваются: организация, кассир, API-ключи, вебхуки и история счетов остаются на месте. Оплатили тариф — работа продолжается с того же места. Незакрытые возвраты и отмены доводите до конца до окончания теста.
Два приятных правила:
- Оплата в любой момент теста не сжигает бесплатные дни: срок тарифа отсчитывается от конца тестового периода, а не от даты оплаты. Оплатить в первый день теста — не «потерять» два дня.
- Не успели за 3 дня — попросите продление в поддержке WhatsApp 77003076512.
Как выбрать тариф после теста и почему это фикс, а не процент — «Тарифы и комиссия ApiPay».
Вопросы и ответы
Нужна ли карта или предоплата для теста?
Нет. Тест включается без платёжных данных. После него платные операции отвечают 403 tariff_inactive до оплаты тарифа.
«Всё настроил, а оплата не приходит»?
Проверьте переключатель режима: при включённой песочнице счета в Kaspi не уходят и покупателю ничего не приходит, хотя в логах всё «успешно».
Тест даётся один раз?
Один раз на организацию. Каждая новая подключённая организация получает свои 3 дня. Повторный триал не открывается, если вы переподключаете кассира той же организации — даже после отвязки. Если не успели за 3 дня — напишите в поддержку, срок продлевают по запросу.
Если я оплачу тариф на второй день теста, я потеряю день?
Нет. Срок оплаченного тарифа начнётся с конца тестового периода — бесплатные дни не сгорают.