Настройка модуля оплаты Яндекс.Касса (новая версия API, с поддержкой 54ФЗ, онлайн-кассы, онлайн-чеки) для юридических лиц в VamShop

[support 447]

В VamShop по умолчанию уже встроен модуль оплаты Яндекс.Касса с поддержкой 54ФЗ, онлайн-касс, онлайн-чеков в Админке — Модули — Оплата — yandex_kassa. Именно о настройке этого модуля пойдёт речь в данной заметке.
Все платежи с помощью данного модуля Вы будете получать на свой расчётный счёт в банке.

Кроме того, есть ещё модуль яндекс кассы yandex_merchant — это устаревший модуль со старой версией API, т.е. он подходит только для тех кто подключился к Яндекс.Кассе давно. Для пользователей, которые подключаются к яндекс.кассе начиная с 2019 года, нужно использовать именно данный модуль — yandex_kassa с поддержкой текущего API яндекс.кассы.

Итак, Вы решили подключиться к платёжной системе Яндекс.Касса.

С помощью данной платёжной системы можно принимать любые платежи от покупателей (через карточки visa, mastercard, мир, яндекс.деньги, онлайн-банки, сбербанк онлайн, киви, webmoney и т.д.). Яндекс.Касса — самый крупный и популярный агрегатор платежей, т.е. Вы заключаете 1 договор с яндексом и получаете возможность принмать оплату десятками различных способов. Оплата приходит на Ваш расчётный счёт за вычетом комиссии яндекса.

Подключение к Яндекс.Кассе проходит в четыре этапа:
1. Регистрация в платёжной системе Яндекс.Касса в качестве продавца.
2. Заполнение анкеты.
3. Получение необходимых для работы данных.
4. Настройка модуля оплаты Яндекс.Касса в VamShop.

1. Регистрация в качестве продавца происходит на странице — https://kassa.yandex.ru/joinups/?source=vamshop . Регистрируйтесь, получаете договор, подписывайте, отправляйте в яндекс.
2. Вам пришлют документацию (Протокол обмена информацией при осуществлении переводов HTTP-транспорт) и техническую анкету, в которой нужно указать всю необходимую информацию о Вашем магзаине. Пример заполнения анкеты прицепил в конце данного сообщения. Так же прицепил к сообщению внизу документацию.

Важное замечание по пунктам paymentAvisoURL и checkURL из технической анкеты.

В обоих опциях должно быть указано: https://ваш-магазин.ру/yandex_kassa.php

Обратите внимание, что указывается безопасный HTTPS протокол, т.е. у Вашего хостинг провайдера должен быть настроен SSL. Ваш сайт должен иметь SSL сертификат, достаточно самоподписанного сертификата. Убедитесь, что у Вас в браузере открывается страница https://ваш-магазин.ру/yandex.php , а не отдаёт 404 код.

Это важно. Без SSL Вы не сможете принимать у себя в магазине Яндекс.Касса в автоматическом режиме. В этом случае используйте другие модули оплаты-агрегаторы. Например robokassa, prochange. Информация по на стройке данных модулей уже была ранее в нашем блоге, читайте.

3. После регистрации Вам пришлют пример html-формы платежа, из этой формы возьмите свои значения опций shopID и Секретный ключ. Это будут числовые значения.
4. В Админке — Модули — Оплаты включайте модуль yandex_kassa. В настройках модуля оплаты указывайте свои значения опций shopID, Секретный ключ. Секретный ключ — это Ваш пароль, который Вы указали в анкете при подключении к Яндекс.Деньгам, в опции shopPassword. Вот значение shopPassword из своей анкеты и записывайте в опцию Секретный ключ. Укажите оплаченны статус заказа, т.е. заказы, оплаченные с помощью яндекс.денег будут автоматически менять статус на указанный.

Всё. Теперь Вы можете принимать в своём магазине платежи из Яндекс.Кошельков, а так же платежи по карточкам (Visa, MasteCard, Maesto).

Настройки уведомлений об оплате.

Если Вы хотите настроить автоматическую смену статуса заказа в магазине при оплаты заказа, Вам надо сделать ещё кое что.

Для того, что б успешно оплаченный через яндекс.кассу заказ автоматически изменял свой статус у Вас в магазине (например ставился статус Оплачен), Вам надо в Вашем кабинете https://kassa.yandex.ru настроить уведомления.

В разделе Настройки — Настройка магазина смотрите раздел HTTP-уведомления.

Редактируйте опцию URL для уведомлений и укажите в данной опции следующий адрес: https://ваш-магазин.ру/yandex_kassa.php

Обратите внимание, что у Вас в магазине уже должен быть установлен SSL сертификат, без сертификата работать не будет.

В опции События можно оставить выделенными все события, либо выделить только payment.succeeded

Всё. Уведомления настроили. Теперь у Вас в магазин успешно оплаченный через яндекс.кассу заказ будет автоматически изменять свой статус.

Статус оплаченного заказа настраивается в Админке — Модули — Оплата, в настройках модуля yandex_kassa. В опции Укажите оплаченный статус заказа

Файлы:

Пример заполнения анкеты.
Протокол обмена информацией при осуществлении переводов (HTTP-транспорт).

Читать заметку полностью