Пошаговые сценарии по разделу Платежные провайдеры

Как пользоваться этим документом

Этот документ нужен, когда сотруднику важен не общий обзор раздела, а конкретный рабочий маршрут.

Если нужен общий обзор интерфейса, откройте:

Если нужен короткий ответ на вопрос, откройте:

Если в процессе возникает ошибка или непонятное поведение, откройте:

Сценарий 1. Как создать первый рабочий аккаунт YooKassa

  1. Откройте Система -> Настройки -> Платежные провайдеры.
  2. Если хотите сначала проверить интеграцию безопасно, заранее создайте тестовый магазин на стороне платежного провайдера. Пошаговый разбор есть в интеграции YooKassa.
  3. Нажмите Создать.
  4. Заполните Наименование.
  5. Оставьте Активирован включенным, если аккаунт готов к рабочему использованию.
  6. В Тип провайдера выберите YooKassa.
  7. В поле Public key введите Shop ID из YooKassa.
  8. Введите Secret key.
  9. При необходимости заполните Return URL.
  10. Убедитесь, что Режим подтверждения стоит Redirect.
  11. Нажмите Создать.

Практический результат:

Минимальный рабочий вариант для этого сценария:

  • Наименование
  • Public key
  • Secret key

Сценарий 2. Как настроить webhook после создания аккаунта

  1. Откройте сохраненную карточку аккаунта.
  2. Перейдите к блоку Что куда копировать.
  3. Найдите строку с Webhook URL.
  4. Скопируйте этот адрес.
  5. Откройте кабинет YooKassa.
  6. Вставьте этот адрес в настройку webhook.
  7. Сохраните webhook в кабинете провайдера.

Практический результат:

Сценарий 3. Как обновить Secret key, не создавая новый аккаунт

  1. Откройте нужную карточку платежного аккаунта.
  2. Не меняйте остальные поля без необходимости.
  3. Введите новый Secret key.
  4. Нажмите Сохранить.

Практический результат:

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

Сценарий 4. Как сохранить карточку, не меняя старый секретный ключ

  1. Откройте существующую карточку аккаунта.
  2. Измените только нужные несекретные поля, например Наименование или Return URL.
  3. Поле Secret key оставьте пустым.
  4. Нажмите Сохранить.

Практический результат:

  • несекретные параметры обновляются, а старый секретный ключ сохраняется

Сценарий 5. Как безопасно отключить онлайн-оплату через конкретный аккаунт

  1. Откройте карточку нужного аккаунта.
  2. Выключите переключатель Активирован.
  3. Нажмите Сохранить.
  4. После этого проверьте приложение, если нужно убедиться в результате.

Практический результат:

  • новые платежи через этот аккаунт больше не должны предлагаться как рабочий вариант

Сценарий 6. Как довести аккаунт до реальной оплаты в приложении

  1. Создайте и сохраните платежный аккаунт.
  2. Настройте Webhook URL у провайдера.
  3. Привяжите этот аккаунт к нужному приложению компании.
  4. Убедитесь, что в CMS-компоненте оформления заказа включена онлайн-оплата.
  5. Сделайте тестовый заказ.
  6. Проверьте, что покупатель уходит на страницу оплаты и затем возвращается обратно корректно.

Что это дает:

  • аккаунт проходит путь от простой записи в справочнике до рабочего инструмента в клиентском приложении