Все статьи
Интеграции

Как безопасно подключать оплату к сайту

Почему платёжная логика должна выполняться на сервере и как Vixy разделяет frontend, ключи и интеграции.

7 мин чтенияОбновлено: Fri Nov 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
Платёж считается завершённым не тогда, когда покупатель вернулся на страницу «Спасибо», а когда сервер получил и независимо подтвердил статус у платёжной системы.

Главный принцип

Секреты и деньги не должны доверять браузеру

Ключи скрыты

Shop ID и секретный ключ хранятся отдельно от файлов проекта и переписки с AI.

Сумма с сервера

Сервер читает товары из базы и не принимает итоговую цену от посетителя.

Статус перепроверяется

Вебхук и страница результата сверяются с API платёжного провайдера.

Уведомление после проверки

Сообщение продавцу отправляется только после подтверждённой оплаты.

Небезопасный подход

  • Ключ записан в React-коде
  • Браузер передаёт итоговую сумму
  • Успех определяется параметром URL
  • AI генерирует произвольный серверный код

Подход Vixy

  • Ключ хранится зашифрованным
  • Сумма считается по базе
  • Статус повторно запрашивается
  • Платёжный сценарий фиксирован платформой

Как проходит платёж

Один заказ — одна проверяемая цепочка

  1. 1

    Сайт передаёт состав корзины

    Только идентификаторы товаров, количество и контактные данные покупателя.

  2. 2

    Vixy рассчитывает заказ

    Проверяет товары и цены, сохраняет заказ и создаёт идемпотентный платёж.

  3. 3

    Покупатель оплачивает

    Переходит на защищённую страницу провайдера и затем возвращается на сайт.

  4. 4

    Vixy подтверждает результат

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

Что делать при неизвестном статусе

Не показывать успешную оплату заранее. Оставить заказ в ожидании и повторить безопасную проверку по его идентификатору.

Перед запуском

Минимальный платёжный чек-лист

Ключи отсутствуют в файлах проекта
Сумма не передаётся из браузера
Используется уникальный checkoutId
orderId сохраняется перед переходом
Статус проверяется после возврата
Обрабатываются pending и canceled
Проверен повторный клик по кнопке
Проведён платёж на минимальную сумму

Подключайте оплату через проверенный сценарий

Технические параметры, формат таблицы товаров и пример клиентского вызова собраны в документации.

Посмотреть техническую инструкцию