Тестовый режим платежной системы: песочница, вебхуки и переход в боевой режим

Что такое тестовый режим платёжной системы и зачем он нужен

Тестовый режим (его же называют песочницей или sandbox) — это копия боевого API, в которой платежи имитируются. Вы вызываете те же методы, получаете те же статусы и вебхуки, но деньги не списываются и не зачисляются.

Ошибки на боевой кассе стоят дорого: покупатель заплатил, а доступ не выдан; товар выдан дважды; заказ навсегда завис в статусе «ожидает оплаты». В песочнице такие баги ловятся бесплатно и без нервов.

Песочница, тестовый режим, демо — это одно и то же?

Термины часто используют как синонимы. Где-то это отдельный стенд с отдельным адресом, где-то — переключатель в том же кабинете, а «демо» — готовая страница для знакомства с интерфейсом. Суть одна: безопасно прогнать сценарии оплаты до запуска.

Как именно устроен тестовый режим в Paydex, какие данные использовать и что доступно — смотрите в документации по тестовому режиму. Мы не дублируем здесь детали, чтобы вы не опирались на устаревшие значения.

Что проверять в тестовом режиме: полный список сценариев

Новички обычно проверяют только «счастливый путь»: оплатил — всё работает. Но проблемы чаще возникают на краях: отмена, повтор уведомления, истёкший срок. Вот минимальный набор.

Если у вас несколько способов оплаты — например, СБП, карты РФ и USDT, — пройдите сценарии для каждого. Страницы и статусы могут отличаться, и лучше увидеть это заранее.

Как начать тестировать интеграцию в Paydex: порядок действий

Paydex — платёжный шлюз для сайтов, онлайн-сервисов и Telegram-ботов. Подключение занимает обычно один день: регистрация, проект, подтверждение домена или бота, модерация (как правило, до суток) и ключи API. ИП, ООО и самозанятость не требуются — мы работаем с обычными физическими лицами.

1. Зарегистрируйтесь и создайте проект — сайт или Telegram-бота.
2. Откройте быстрый старт и выберите способ интеграции: REST API, платёжные ссылки или SDK для Node.js, PHP, Python.
3. Включите тестовый режим по инструкции из документации и получите данные для тестов.
4. Подключите вебхуки и прогоните сценарии из таблицы выше.
5. Проверьте возвраты и обработку ошибок.
6. Когда всё работает, переходите на боевой режим.

Тестовые счета и платежи: как смоделировать успех, отказ и зависание

Тестовые счета — это заказы, которые вы создаёте через API так же, как боевые, но оплата по ним имитируется. Смысл в том, чтобы вызвать каждый возможный статус и убедиться, что ваш код его понимает.

Успешная оплата

Создайте счёт, откройте страницу оплаты, завершите платёж. Проверьте три вещи: пришёл ли вебхук, совпала ли сумма и идентификатор заказа, выдан ли товар. Статус в вашей базе должен меняться только по подтверждённому уведомлению, а не по возврату покупателя на страницу «Спасибо».

Отказ, отмена и истёкший срок

Закройте страницу оплаты, не завершив платёж, и дождитесь истечения срока. Покупатель не должен видеть «вечную загрузку», а вы — зависшие заказы. Проверьте, что ваш сервис умеет создавать новый счёт по тому же заказу и не путает старый с новым.

Разные способы оплаты

СБП (QR и ссылка), банковские карты РФ и USDT (TRC20, BEP20) для покупателя выглядят по-разному. Убедитесь, что на мобильном экране QR читается, ссылка открывается в приложении банка, а для USDT покупатель видит сеть и сумму. Это проверка не платёжной системы, а вашего интерфейса вокруг неё.

Как проверить вебхуки в тестовом режиме

Вебхук — главный источник истины об оплате. Подписанные вебхуки с повторной доставкой в Paydex защищают от потерянных уведомлений, но ваш обработчик должен быть к этому готов. Подробнее о механике — в документации по вебхукам и в нашей статье про вебхук оплаты в блоге.

• Публичный HTTPS-адрес. Для разработки на своём компьютере поднимите туннель или используйте тестовый сервер — платёжная система должна достучаться до вашего обработчика.
• Проверка подписи. Считайте подпись по сырому телу запроса, а не по перепакованному JSON. Отправьте тестовый запрос с неверной подписью и убедитесь, что он отклоняется.
• Быстрый ответ. Подтверждайте получение сразу, а тяжёлую логику (выдачу товара, письма) выносите в очередь.
• Идемпотентность. Один и тот же вебхук может прийти несколько раз. Храните идентификатор события или платежа и не выдавайте товар повторно.
• Повторная доставка. Намеренно ответьте ошибкой и убедитесь, что при следующей попытке всё обработается корректно.
• Логи. Сохраняйте тело, заголовки и результат обработки — при споре это спасёт часы поиска.

Возвраты и типичные ошибки интеграции

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

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

Ошибки, которые чаще всего находят в песочнице

• Сумма передаётся в неверном формате или округляется по-разному на сайте и в запросе.
• Идентификатор заказа не уникален, и два покупателя получают один счёт.
• Обработчик вебхука падает на неожиданном поле и не отвечает.
• Товар выдаётся и по вебхуку, и по возврату на страницу успеха — то есть дважды.
• Часовой пояс сервера сбивает сроки жизни счёта.
• Секретный ключ лежит в коде фронтенда или в публичном репозитории.

Тестовый и боевой режим: чем отличаются и что проверить перед запуском

Чек-лист перед переходом в боевой режим

1. Все сценарии из таблицы выше пройдены, баги исправлены.
2. В коде заменены тестовые ключи на боевые, адрес вебхука указывает на рабочий сервер.
3. Подпись вебхуков проверяется, повторные уведомления не ломают логику.
4. Ключи вынесены в переменные окружения и не попадают в репозиторий.
5. Оферта с блоком «Возврат» и контакты опубликованы на сайте или в боте.
6. Подготовлен план первой реальной оплаты на небольшую сумму.

Как перейти в боевой режим с Paydex

Боевой режим открывается после модерации проекта. Проверяющие смотрят на работающий сайт или бота, товары и цены, публичную оферту с блоком «Возврат» и контакты. Заранее сверьтесь с требованиями к сайту — это сэкономит время и повысит шанс пройти с первого раза.

Дальше всё просто: вы получаете боевые ключи API, подставляете их в окружение, обновляете адрес вебхука и делаете пробную оплату. Деньги поступают на баланс в USDT, а вывести их можно в USDT (TRC20, BEP20) или в рублях — на карту либо по СБП.

Платы за подключение и абонентской платы нет, а комиссия зависит от оборота и тематики. Актуальные условия смотрите на странице тарифов, а если что-то не получается — пишите в поддержку Paydex в Telegram.

С чего начать сегодня

Хорошая интеграция — это не «заработало с первого раза», а «сломалось в песочнице и починено до запуска». Отведите на тесты полдня, пройдите сценарии по списку выше — и боевой запуск пройдёт спокойно.

Зарегистрируйтесь в Paydex, создайте проект, прогоните тестовые платежи и переходите к приёму реальных оплат — СБП, карт РФ и USDT.