Этот способ подключения используется только для новых дизайнов и для тех, кто подключил ЮKassa после октября 2017 года. Руководство по интеграции ЮKassa по старому API можно найти по ссылке. Если вы сомневаетесь в выборе способа настройки для вашего сайта — по старой или новой версии API — отправьте заявку в Личном кабинете. Мы подскажем какой способ актуален для вас.
ВАЖНО: Вы можете подключить систему оплаты ЮKassa для принятия платежей, только если являетесь индивидуальным предпринимателем, самозанятым или юридическим лицом. Если вы являетесь физическим лицом, то вам необходимо выбрать другой вариант оплаты.
Подключайте систему ЮKassa только при наличии сайта, который доступен по реальному доменному имени. Вы НЕ можете подключить систему оплаты до тех пор, пока ваш сайт доступен по служебному адресу для заполнения.
Подключение
Чтобы настроить взаимодействие ЮKassa с сайтом, вам необходимо выполнить несколько шагов. Вы также можете использовать руководство ЮKassa для настройки подключения.
1. Зарегистрируйтесь в сервисе по ссылке yookassa.ru/joinups. У вас появится личный кабинет.
2. Заполните данные для договора и загрузите копии документов (в личном кабинете ЮKassa).
3. Дождитесь проверки отправленных данных и подпишите договор с ЮKassa.
Специалисты ЮKassa могут попросить вас заполнить техническую анкету следующего образца:
В анкете вам нужно указать:
- наименование вашего магазина (как оно будет отображаться у вашего покупателя)
- адрес вашего сайта (с протоколом http:// или https://)
- в адресе для уведомлений введите ссылку https://secure.vigbo.com/yookassa/notification.php
- Email для реестров — укажите здесь ваш email, на который ЮKassa вам будет направлять сообщения.
Сохраните анкету и отправьте ее специалисту ЮKassa. Дождитесь получения данных для дальнейшей настройки.
Если анкету вам не отправляли, то переходите к следующему шагу.
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.
ВАЖНО: если на стороне ЮKassa вы подключили сразу и онлайн-кассу, то в настройках вашего интернет-магазина на сайте для метода оплаты ЮKassa отметьте чек-бокс Отправлять данные для чека в онлайн-кассу. Если этого не сделать, то платежи на сайте не будут проходить. Информацию по подключению онлайн-кассы вы можете почитать в руководстве Онлайн-кассы для интернет-магазинов.