Подключение магазина

Attention. Это старая версия API. Переходите на API Яндекс.Кассы.
Для начала в любом случае нужно подать заявку на подключение. У вас появится доступ в личный кабинет — в нем можно заполнить анкету об организации, выбрать способ подключения и прописать технические настройки. Если в личный кабинет нет доступа, свяжитесь с менеджером Кассы: merchants@yamoney.ru.

После выбора способа подключения у вас появится доступ к тестовой среде Яндекс.Кассы и тестовые настройки, а после отладки — настройки для взаимодействия в рабочем режиме. Подключать возможность управления платежами (MWS) нужно отдельно.

Шаг 1. Выберите способ подключения и реализуйте протокол

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

Одновременно можно использовать только один способ подключения. Когда сделаете выбор, зафиксируйте его в личном кабинете. Там же можно указать параметры, которые необходимы для работы с Кассой. Будьте внимательны: настройки для разных способов подключения отличаются Подробнее о настройках

Количество доступных способов оплаты от способа подключения не зависит.

HTTP-протокол

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

Email-протокол

Подключение по схеме Email-протокол не предполагает обратной связи с сервисом: информация о совершенной оплате приходит в письме. Разрабатывать ничего не нужно: при подключении вы получите код платежной формы, который просто вставите на сайт.

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

В личном кабинете Кассы выделен еще один способ подключения — Платежный модуль. Схема взаимодействия та же, что и при подключении по схеме HTTP-протокол: уведомления об операциях отправляются в виде HTTP-запросов. Но дополнительная разработка не нужна, обо всем уже позаботились разработчики системы: вам достаточно установить или активировать готовый модуль и прописать настройки. На сайте Кассы есть список готовых платежных модулей для разных систем: CMS, Saas, CRM, мессенджеров и фреймворков. Если ваша система есть в списке — значит, вам подходит этот способ подключения.

Шаг 2. Настройте взаимодействие с онлайн-кассой

Note.

Этот шаг необходим только тем, кто собирается настраивать взаимодействие со своей онлайн-кассой через Яндекс.Кассу. Его следует пропустить, если вы самостоятельно отправляете в свою онлайн-кассу данные для чека или выбиваете чеки вручную.

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

Шаг 3. Протестируйте прием платежей

Если вы планируете тестировать работу вашего магазина, при выборе способа подключения в личном кабинете поставьте галочку «Я буду проводить тестовые платежи». Когда ваш магазин подключат к тестовой среде (demomoney.yandex.ru), вам придет письмо с тестовыми параметрами. (Письмо отправляется на адрес контактного лица по техническим вопросам, который вы указали в личном кабинете.) Эти параметры появляются также в личном кабинете, в разделе Настройки. Подставьте их в платежную форму на вашем сайте.

Для самостоятельного тестирования платежей вы можете воспользоваться тестовыми данными.

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

Note.

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

Шаг 4. Переведите прием платежей в рабочий режим

Вы можете перевести платежную форму в рабочий режим, если:

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

Смотрите также

Платежная форма

Тестовые данные