Технические настройки

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

Важно. Если ваша компания в России, заполните настройки в личном кабинете. Если нет — менеджер пришлет вам техническую анкету. В остальном техническая сторона подключения не зависит от страны.

Уведомления о платежах

Это сообщения, которые приходят вам после успешной оплаты. Их можно получать разными способами:

  • По электронной почте — уведомление о каждом платеже приходит на электронную почту (адрес фиксируется в личном кабинете). В этом случае вам придется обрабатывать каждое письмо вручную. Письма о неуспешных платежах приходить не будут.
  • По HTTP — уведомления приходят на специальный адрес (URL) на вашем сайте или сервисе (его тоже нужно указать в личном кабинете). Их можно обрабатывать автоматически: в самописном сервисе или в CMS.

Зачем нужна автоматическая обработка уведомлений

Чтобы подгружать информацию об оплате в вашу систему. Например, менять статус заказа в интернет-магазине на оплаченный. Или сразу загружать информацию о платеже в 1С.

Пример

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

Магазин получает уведомления по HTTP и в режиме реального времени обрабатывает информацию об оплате. Менеджер зайдет в панель управления, откроет список заказов и увидит, что заказ Анны оплачен, а заказ Петра — еще нет.

Способ подключения

Определяет способ, которым вы будете получать уведомления о платежах. В Кассе всего три способа:

  • Email-протокол: уведомления приходят на электронную почту. Годится, если у вас нет автоматической обработки заказов. Несложно настроить на любом сайте.
  • HTTP-протокол: уведомления приходят на адрес вашей системы. Годится для автоматической обработки заказов. Нужна дополнительная разработка с интеграцией по протоколу приема платежей.
  • Платежный модуль: уведомления приходят на адрес вашей системы. Годится, если ваш сайт работает на основе CMS, SaaS или фреймворке с модулем Кассы. Дополнительная разработка не нужна: достаточно установить и настроить модуль. Список модулей с Кассой

Важно. Нероссийские компании могут работать с платежными модулями Кассы. Но нужно проверять, что модуль поддерживает нужную валютную схему. Подробнее о валютах

Настройки в личном кабинете

Зависят от вашего способа подключения. Сначала выберите его:

Email-протокол

HTTP-протокол

Платежный модуль

Как это выглядит в личном кабинете

Способ можно поменять, пока анкета не отправлена. Все настройки можно сохранять в процессе, а потом возвращаться и дописывать.

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

Email-протокол

Как это выглядит в личном кабинете

Укажите адрес, на который хотите получать уведомления о платежах, и можно сразу отправлять настройки менеджеру.

HTTP-протокол

Как это выглядит в личном кабинете

Укажите адреса, на которые будут приходить уведомления:

checkUrl — на него будут приходить запросы на проверку параметров платежа перед оплатой.

avisoUrl — на него будут приходить уведомления об успешных платежах.

Внимание! Уведомления от Кассы работают только по HTTPS: для этого на вашем сайте должен быть установлен SSL-сертификат. Если просто поставить в начале адреса https, ничего не получится.

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

Если вам нужны эти страницы, включите переключатель Использовать страницы успеха и ошибки с динамическими адресами и укажите эти адреса:

shopSuccessUrl — страница, которую покупатель увидит после успешной оплаты.

shopFailUrl — страница, которую покупатель увидит после ошибки платежа.

Чтобы при тестировании получать уведомления на другие адреса, включите переключатель Я буду проводить тестовые платежи и укажите нужные адреса.

Осталось заполнить оставшиеся параметры:

Email для доставки реестров — на него будут приходить письма с ежедневными платежными реестрами.

shopPassword — это секретное слово, оно понадобится при обработке уведомлений от нашего сервиса.

Платежный модуль

Как это выглядит в личном кабинете

Сначала выберите систему, на которой работает ваш сайт или сервис. Все адреса подставятся автоматически: их можно править, только если вы уверены, что это нужно.

Если не нашли, уточните у менеджера, есть ли уже платежный модуль для вашей системы. В этом случае вы всё равно можете подключить Кассу — но другим способом. Без интеграции, с уведомлениями по почте. Или с интеграцией по нашим протоколам — в этом случае придется разработать модуль для вашей системы самостоятельно.

Заполните оставшиеся параметры:

Email для доставки реестров — на него будут приходить письма с ежедневными платежными реестрами.

shopPassword — секретное слово, его нужно будет указать в настройках модуля на вашей стороне.

Бесплатный SSL-сертификат

Cертификат для домена нужен, если ваш способ подключения к Кассе — Платежный модуль или HTTP-протокол. В этом случае наш партнер REG.RU выдает бесплатные сертификаты. Получить их можно прямо в личном кабинете, в разделе Настройки, если вы уже подписали договор с Кассой.

Как получить сертификат из личного кабинета:

  1. Заполните анкету об организации, подпишите договор и отправьте на проверку.
  2. Заполните технические настройки. Сохраните, но на проверку не отправляйте.
  3. Когда договор проверят, в Настройках появится кнопка Получить сертификат.
Как это выглядит

Сертификат можно получить только для одного сайта, который подключается к Кассе. Если в личном кабинете получить сертификат не удалось, запросите его у менеджера. В некоторых случаях можно получить дополнительный сертификат, для второго сайта.

Настройки на вашей стороне

В любом случае вам понадобится:

  • shopId — внутренний идентификатор магазина в Яндекс.Кассе,
  • scid — внутренний идентификатор платежной формы в Яндекс.Кассе,
  • shopPassword — секретное слово (вы сами его указываете в личном кабинете при подключении).

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

Email-протокол

Вам достаточно вставить на сайт платежную форму, чтобы у покупателей появилась кнопка Заплатить через Яндекс (или другая на ваш выбор). Форму можно запросить у менеджера или сконструировать самостоятельно (посмотреть параметры и шаблон).

Код формы — это обычный html-код, его можно просто вставить в код вашего сайта, главное — правильные параметры.

Примечание

Форму можно отредактировать в любом текстовом редакторе. Параметры нужно писать точно как в документации, регистр важен.

HTTP-протокол

Для подключения магазина нужна разработка по Протоколу приема платежей.

Подробнее об этапах подключения и разработки

Платежный модуль

Всё зависит от вашей системы и от версии модуля, который вы используете. Можно посмотреть в инструкции: как правило, она встроена в модуль. Если нет, спросите у разработчиков модуля или CMS.

Большинство инструкций можно скачать в нашем списке модулей.