Один из самых частых вопросов на этапе интеграции — «а как проверить, что всё работает, прежде чем подключать реальные платежи?». Раньше для этого приходилось либо проводить платёж на минимальную сумму и потом возвращать деньги, либо заводить отдельную тестовую кассу и путаться в двух наборах ключей.
Мы убрали этот барьер: в RollyPay появился тестовый режим оплаты — полноценная песочница прямо на вашей боевой кассе, с тем же API-ключом, но без единого рубля реальных денег.
Зачем нужен тестовый режим
Тестовый режим создан для того, чтобы разработчик или интегратор мог спокойно, без спешки и риска, пройти весь путь оплаты от начала до конца: создать платёж, открыть платёжную форму, получить колбэк и убедиться, что бизнес-логика на стороне проекта отрабатывает корректно.
- проверить, что запрос на создание платежа собран правильно;
- убедиться, что платёжная форма открывается и отображает нужную сумму и заказ;
- протестировать обработку разных исходов — успешную оплату и отклонённый платёж;
- проверить приём и подпись колбэков на своей стороне;
- показать сценарий оплаты команде или заказчику ещё до запуска.
И всё это — без риска списать реальные деньги, без лишней бухгалтерии и без необходимости заводить отдельную тестовую кассу.
Что гарантирует изоляция
Тестовый платёж — это полноценная копия боевого сценария, но полностью изолированная от реальных процессов:
- Деньги не двигаются. Ни списаний, ни зачислений — тестовый платёж не затрагивает баланс мерчанта.
- Лимиты кассы не расходуются. Тестовые платежи не учитываются в лимитах и ограничениях кассы.
- Аналитика не засоряется. Тестовые платежи не попадают в отчёты, обороты и метрики — статистика остаётся чистой.
- Кэшбэк не начисляется. RollyCoin начисляется только по реальным оплатам.
При этом сам сценарий — от создания платежа до получения колбэка — полностью повторяет боевой: те же переходы статусов, та же подпись колбэков, тот же формат ответа API. Это значит, что код, протестированный в песочнице, будет работать точно так же и в проде.
Как включить тестовый режим
Отдельная тестовая касса или отдельный ключ не нужны — тестовый режим включается прямо в запросе на создание платежа. Достаточно добавить одно поле:
POST /api/v1/payments
{
"amount": "1500.00",
"payment_currency": "RUB",
"order_id": "order_test_001",
"test": true
}Вместо поля в теле запроса можно передать заголовок X-Test-Mode: true — работает точно так же. В ответе и в самом объекте платежа появится пометка "environment": "sandbox", по которой легко отличить тестовый платёж от боевого.
Как проходит оплата в тестовом режиме
При переходе по ссылке на оплату тестового платежа вместо обычного QR-кода клиент увидит баннер «Тестовый режим» и две кнопки — «Симулировать успешную оплату» и «Симулировать отклонение». Не нужен ни реальный банк, ни сканер — статус платежа переключается вручную одним нажатием, а дальше всё происходит так же, как при настоящей оплате: платёж переходит в нужный статус, а на callback_url приходит уведомление.
Колбэк тестового платежа помечен так же явно, как и сам платёж — полем "test": true в теле запроса и заголовком X-Test-Mode: true. Подпись колбэка считается точно так же, как и для боевых уведомлений, поэтому проверить обработку можно тем же кодом, который уже используется в проде.
Тестовые платежи в личном кабинете
Тестовый режим доступен не только через API, но и прямо в личном кабинете — как в текущей версии, так и в новой на new.rollypay.io.
- В разделе платежей появилась отдельная вкладка «Тестовые» — боевые и тестовые платежи больше не путаются между собой;
- Каждый тестовый платёж отмечен пометкой «Тест» — в списке и в деталях;
- В окне создания платежа добавлен переключатель «Тестовый платёж» — можно создать тестовый платёж вручную, без единой строчки кода, буквально в два клика.
Это особенно удобно, если нужно быстро показать сценарий оплаты коллеге или заказчику, не трогая при этом реальные деньги и статистику кассы.
Документация: подробный гайд по тестовому режиму
Мы подготовили отдельный раздел в документации, где подробно расписан весь процесс: как включить тестовый режим, что именно гарантирует изоляция, как симулировать оплату на платёжной форме, как выглядят тестовые колбэки и как получить список тестовых платежей через API.
Подробнее — в разделе «Тестовый режим (Sandbox)» →
Что это значит для вашей интеграции
Тестовый режим — это возможность спокойно и без спешки проверить весь платёжный сценарий перед запуском: убедиться, что оплата проходит корректно, что колбэки приходят вовремя и с правильной подписью, а обработка ошибок отрабатывает так, как задумано. И всё это — на той же кассе, с тем же ключом, без единого реального рубля.
Попробуйте создать тестовый платёж прямо сейчас — в личном кабинете или через API — и пройдите весь путь оплаты от начала до конца.