Какой тестовый период у ApiPay и что в него входит?

Чем тестовый период отличается от песочницы?

Представьте автосалон. Песочница — это тренажёр: садитесь за руль, жмёте педали, ничего не едет и ничего не ломается. Тестовый период — это настоящий тест-драйв: 3 дня вы ездите по городу на реальной машине.

• Песочница (sandbox) — учебный режим. Счета создаются только внутри ApiPay, в Kaspi не передаются, покупателям ничего не приходит. Вы можете сами помечать счета «оплачен»/«отменён» и проверять, как ваш сайт или бот реагирует на вебхуки. Кассир и организация для песочницы не нужны, она бесплатна без ограничения срока — некоторые клиенты отлаживаются в ней неделями, и это нормально. Подробно — «Песочница и рабочий режим».
• Тестовый период (триал) — 3 бесплатных дня рабочего режима: счета уходят в Kaspi по-настоящему, покупатели получают push и платят, деньги зачисляются на ваш Kaspi-счёт. Это полноценная работа сервиса, просто бесплатная.

Правильный порядок знакомства: сначала отладьте интеграцию в песочнице (бесплатно и не спеша), потом подключите кассира и потратьте 3 тестовых дня на проверку боевых оплат.

Когда начинаются 3 дня и почему «сами»?

Триал активируется автоматически в момент подключения кассира способом 1: кабинет apipay.kz → Настройки → «Авторизация Kaspi» → номер кассира → код из SMS (около 1 минуты). Подключили кассира — с этой секунды пошли 3 дня.

Логика простая: пока кассир не подключён, сервис физически не может выставить ни одного реального счёта — значит, и тесту нечего тестировать. Поэтому:

• регистрация на apipay.kz таймер не запускает;
• работа в песочнице таймер не тратит;
• таймер стартует только вместе с реальной возможностью принимать оплату.

Какой номер годится в кассиры и почему это важно — в статье «Требования к номеру кассира».

Что можно делать в тестовые 3 дня?

Всё то же, что на платном тарифе: выставлять счета по номеру телефона и QR-счета, получать вебхуки, делать возвраты, смотреть статистику. Деньги от покупателей — сразу на ваш Kaspi-счёт, как обычно (ApiPay к деньгам доступа не имеет).

Единственное ограничение — 50 счетов в день. Это защита от злоупотреблений на бесплатном периоде: при попытке создать 51-й счёт API вернёт ошибку 429 с кодом trial_daily_limit («Достигнут дневной лимит счетов на пробном тарифе»). Для честного теста лимита хватает с запасом — он выше, чем дневной лимит тарифа Start (30 счетов/день).

Что происходит после трёх дней?

Если тариф не оплачен, выставление новых счетов приостанавливается — сервис ждёт оплату. Ничего не удаляется: организация, кассир, API-ключи, вебхуки и история счетов остаются на месте. Оплатили тариф — работа продолжается с того же места, ничего перенастраивать не нужно.

Два приятных правила:

• Оплата в любой момент теста не сжигает бесплатные дни: срок тарифа отсчитывается от конца тестового периода, а не от даты оплаты. Оплатить в первый день теста — не «потерять» два дня.
• Не успели протестировать — попросите продление. Выходные, ждали разработчика, искали SIM для кассира — напишите в поддержку, продлеваем без бюрократии.

Как выбрать тариф после теста и почему это фикс, а не процент — «Тарифы и комиссия ApiPay».

Частые ошибки

• Тестировать «боевые» оплаты, не выключив песочницу. Если включён тестовый режим (песочница), счета в Kaspi не уходят и покупателю ничего не приходит — при этом в логах всё «успешно». Проверьте переключатель режима в настройках.
• Ждать, что после теста рабочий режим «включится сам» или «выключится сам». Режим не меняется: после теста просто нужна оплата тарифа, а песочница — отдельный тумблер, который вы переключаете сами.
• Подключать кассира «на будущее», когда интеграция не готова. Триал стартует сразу при подключении — 3 дня уйдут впустую. Сначала песочница, потом кассир.
• Пытаться обойти лимит 50 счетов/день на тесте. Не выйдет (ошибка 429), и не нужно: для нагрузочных экспериментов есть бесплатная песочница.
• Считать, что после теста пропадут настройки. Не пропадут: приостанавливается только выставление новых счетов.

Вопросы и ответы