Онлайн-оплата в магазине

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

Сейчас в магазине доступен один шлюз — Т‑Банк. Другие появятся позже; общие шаги ниже не меняются.

Кратко: заведите эквайринг у выбранного провайдера → укажите ключи в Товары → Настройки магазина → включите режим Онлайн-оплата → проверьте тестовый заказ (можно до публикации, через превью с панели).

Что нужно заранее

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

Режим оформления

В редакторе: Товары → Настройки магазина → Режим оформления.

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

Для приёма денег онлайн нужно и подключить шлюз, и выбрать Онлайн-оплата, затем нажать Сохранить у настроек магазина (рядом с режимом и email).

Не обещайте на сайте «оплату картой онлайн», пока шлюз не подключён и режим не переключён.

Как проходит оплата для покупателя

Товары в корзине → Оформить заказ.
Для онлайн-оплаты нужен email покупателя (без него заказ с оплатой не создастся).
Создаётся заказ со статусом Ожидает оплату, покупатель переходит на страницу оплаты провайдера.
После успешной оплаты статус в панели — Оплачено; при отказе или отмене — Ошибка оплаты.
Покупателю уходят письма о составе заказа и о результате оплаты (от имени вашего магазина). Вам — уведомление на Email уведомлений из настроек магазина.

Где смотреть оплату у себя

Панель управления → Заказы магазина → откройте заказ:

статусы оплаты и выполнения;
блок Детали платежа — провайдер, идентификатор платежа, время оплаты и данные ответа шлюза (если платёж уже запускался).

Статусы оплаты: Не оплачено · Ожидает оплату · Оплачено · Ошибка оплаты · Возвращён.

Общая проверка перед запуском

Магазин включён, товары активны.
Шлюз подключён (статус вроде Онлайн-оплата подключена.), режим — Онлайн-оплата.
В кабинете провайдера настроены страницы возврата после оплаты (успех / ошибка), если он это требует — см. раздел нужного шлюза ниже.
Оформите тестовый заказ с витрины (превью с панели — до публикации, или с опубликованного адреса) и убедитесь, что открывается оплата, после оплаты статус в Заказы магазина обновляется.

Чеклист публикации: Перед публикацией.

Доступные шлюзы

Т‑Банк

Подключение через интернет-эквайринг Т‑Банка. Деньги идут на ваш терминал.

Что нужно в Т‑Банке

Подключённый интернет-эквайринг для ИП или ООО: расчётный счёт, заявка, магазин в личном кабинете. Подробности — в справке Т‑Банка.

Где взять Terminal Key и Password

В личном кабинете интернет-эквайринга: Магазины → нужный магазин → Терминалы.
Тестовый (проверка) или Рабочий (реальные платежи) → Настроить.
Скопируйте:
- Терминал → поле Terminal Key в Ypage;
- Пароль → поле Password в Ypage.

У тестового и рабочего терминалов разные ключи. Сначала удобно подключить тестовый, затем заменить на рабочие.

Страницы успешной и неуспешной оплаты

Их обязательно укажите в личном кабинете Т‑Банка — в настройках терминала, блок Страницы успеха и ошибки → Собственные.

Терминал (Тестовый или Рабочий) → Настроить.
Страницы успеха и ошибки → Собственные.
Укажите ссылки на страницы вашего магазина (тот же адрес, что откроется посетителям после публикации), например:
- успех — «спасибо», корзина или главная;
- ошибка — корзина или страница с контактами.
Сохранить.

Настройте и для тестового, и для рабочего терминала, если пользуетесь обоими. Без этих ссылок покупатель после оплаты может остаться на страницах банка. Статус заказа в Ypage обновляется по уведомлению шлюза — его можно проверить в Заказы магазина, даже если возврат на сайт ещё не настроен идеально.

HTTP-уведомления о статусе для Ypage подставляются автоматически — вручную прописывать адрес вебхука в кабинете банка обычно не нужно.

Как подключить в Ypage

Редактор → Товары → Настройки магазина.
Блок Онлайн-оплата Т‑Банк: введите Terminal Key и Password.
Нажмите Подключить онлайн-оплату.

Статус Онлайн-оплата подключена. — ключи на экране только маской. Замена ключей — Обновить ключи; полное отключение — Отключить.

Не забудьте сохранить режим Онлайн-оплата.

Проверка именно для Т‑Банка

В кабинете банка у терминала заданы собственные страницы успеха и ошибки.
Тестовый заказ — сначала на тестовом терминале.
После тестов и включения рабочего терминала — Обновить ключи на рабочие и снова проверить страницы успеха/ошибки у рабочего терминала.

Фискализация (54‑ФЗ)

Ypage не передаёт данные чека в Т‑Банк при создании платежа. Кассу и чеки настраивайте в договоре и кабинете Т‑Банка / у оператора кассы по их правилам.

Частые вопросы

Какие шлюзы можно подключить?

Сейчас — только Т‑Банк. Другие провайдеры будут добавлены в этот же раздел настроек.

Это оплата тарифа Ypage?

Нет. Здесь — оплата заказов вашего магазина. Подписка и кредиты Ypage: Подписка, Кредиты.

Ключи сохранил, но покупателя не отправляет на оплату

Проверьте: режим Онлайн-оплата сохранён; шлюз «подключён»; магазин включён; в форме заказа указан email. Тестируйте с превью сайта с панели (до публикации) или с опубликованного адреса. Без ключей при режиме оплаты заказ создаётся как заявка без перехода к оплате.

Оплата прошла у банка, а в заказе всё ещё «ожидает»

Статус обычно обновляется по уведомлению от шлюза. Обновите карточку заказа через пару минут. Для Т‑Банка убедитесь, что в Ypage те же Terminal Key и Password, что у терминала оплаты (тестовый и рабочий не смешивайте). При необходимости отметьте оплату вручную и напишите в поддержку Ypage.

Безопасно ли хранить ключи в Ypage?

Да: ключи шифруются, в интерфейсе — только маска. Не присылайте секреты в чаты. При утечке смените пароль у провайдера и заново Обновить ключи в Ypage.

Как отключить онлайн-оплату

В Товары → Настройки магазина нажмите Отключить у блока шлюза и при желании верните Ручное подтверждение.