Этот способ подключения используется только для новых дизайнов и для тех, кто подключил ЮKassa после октября 2017 года. Руководство по интеграции ЮKassa по старому API можно найти по ссылке. Если вы сомневаетесь в выборе способа настройки для вашего сайта — по старой или новой версии API — отправьте заявку в Личном кабинете. Мы подскажем какой способ актуален для вас.
ВАЖНО: Вы можете подключить систему оплаты ЮKassa для принятия платежей, только если являетесь индивидуальным предпринимателем, самозанятым или юридическим лицом. Если вы являетесь физическим лицом, то вам необходимо выбрать другой вариант оплаты.
Подключайте систему ЮKassa только при наличии сайта, который доступен по реальному доменному имени. Вы НЕ можете подключить систему оплаты до тех пор, пока ваш сайт доступен по служебному адресу для заполнения.
Подключение
Чтобы настроить взаимодействие ЮKassa с сайтом, вам необходимо выполнить несколько шагов. Вы также можете использовать руководство ЮKassa для настройки подключения.
1. Зарегистрируйтесь в сервисе по ссылке ЮKassa. У вас появится личный кабинет.
2. Заполните данные для договора и загрузите копии документов (в личном кабинете ЮKassa).
3. Дождитесь проверки отправленных данных и подпишите договор с ЮKassa. Как правило, проверка занимает от 1 до 3 рабочих дней.
4. Настройте прием платежей в тестовом режиме.
- Перейдите в раздел Интеграция > HTTP-уведомления в вашем аккаунте ЮKassa и нажмите Изменить настройки.
В поле URL для уведомлений добавьте адрес: https://secure.vigbo.com/yookassa/notification.php
И отметьте все события, о которых ЮKassa отправляет уведомления.
- Выпустите секретный ключ. В меню Интеграция > Ключи API найдите Секретный ключ и нажмите Выпустить ключ. Скопируйте полученное значение (ЮKassa его не сохраняет — он будет только у вас).
5. Перейдите в систему управления сайтом на страницу Магазин > Продажи > Методы оплаты и добавьте метод оплаты ЮKassa.
6. На открывшейся странице укажите ShopId и Секретный ключ тестового магазина, полученные в личном кабинете ЮKassa, и сохраните настройки.
7. Вернитесь в раздел Магазин > Продажи > Методы оплаты. Здесь вам нужно выбрать, какие варианты оплаты ЮKassa будут доступны на вашем сайте, поставив галочку в строке Отображение.
При необходимости, вы можете поменять названия вариантов оплаты по клику на иконку карандаша.
8. Перейдите на сайт и протестируйте оплату. Обратите внимание, в качестве методов оплаты в тестовом режиме можно использовать только Оплату с произвольной банковской карты и Оплату из кошелька в ЮMoney. Оплата проводится только тестовыми картами. Подробную информацию по тестированию вы можете посмотреть также в руководстве ЮKassa.
На этапе тестирования не подключайте онлайн-кассу и не включайте автоотправку чеков. Это можно будет сделать только после перехода на прием настоящих платежей.
9. Когда проверите, что всё работает, сообщите своему менеджеру в ЮKassa — он включит вам режим для приема настоящих платежей.
10. В настройках метода оплаты вашего сайта замените значения полей ShopId и Секретный ключ данными настоящего магазина в ЮKassa. Проверьте оплату на сайте еще раз с данными реальной карты или кошелька.
11. Проверьте доступные способы оплаты в вашем кабинете ЮKassa в разделе Организация > Реквизиты и договор. Для добавления дополнительных методов оплаты нажмите Подключить новый способ оплаты.
Вы сможете принимать платежи на сайте только теми способами, которые доступны для выбора в системе управления сайтом в меню Магазин > Продажи > Методы оплаты > ЮKassa. В системе управления вам доступны следующие способы: СБП, оплата картой, оплата через Сбербанк, через кошелек ЮMoney, сервис «Заплатить по частям».
ВАЖНО: когда на стороне ЮKassa вы подключили онлайн-кассу, то в настройках вашего интернет-магазина на сайте для метода оплаты ЮKassa отметьте чек-бокс Отправлять данные для чека в онлайн-кассу. Если этого не сделать, то платежи на сайте не будут проходить. Информацию по подключению онлайн-кассы вы можете почитать в руководстве Онлайн-кассы для интернет-магазинов.
ЮKassa предоставляет возможность редиректа на сайт после оплаты. Если эта настройка включена, то ваш пользователь автоматически будет перенаправлен на сайт после завершения платежа. Активировать эту настройку вы можете через вашего менеджера или через поддержку ЮKassa. Достаточно отправить запрос из вашего кабинета в ЮKassa в формате: «Подключите авторедирект при успешной оплате для shopID». shopID можно найти в личном кабинете ЮKassa, вверху страницы вашего магазина.