Как подключить и настроить коннектор «ЮКасса»?

Для подключения коннектора необходимо подключить Аккаунт ПланФикс. Как это сделать смотрим по ссылке.


Видео инструкция подключения и настройки коннектора доступна по ссылке.


Далее необходимо подключить сервис ЮКасса на сайте getupd.io вкладка Аккаунты.



Нажимаем Добавить и переходим в настройки,


  

Где: 

Название — произвольное название подключения.

ID магазина — ID вашего магазина на сайте yookassa.ru

API ключ — API ключ на сайте yookassa.ru



Подключив аккаунт Юкасса, переходим во вкладку Коннекторы, Создать коннектор. 

Переходим в ПланФикс. 

Для работы с ЮКасса, нам нужно создать новый шаблон документа, с полями: URL Возврата, Сумма платежа, Статус платежа, Платежная ссылка. 


Обратите внимание - при создании нового поля в шаблоне есть параметр "Тип поля". Для полей Платежная ссылка и Статус оплаты - тип поля можно не менять, по умолчанию будет Строка.

Для поля Сумма платежа тип поля - число.


! При создании поля Платежная ссылка, советую перевести триггер Отображать как гиперссылку в состояние Включен и выбрать https протокол.



Теперь будем создавать кнопку. 

В ПланФикс переходим в Настройки — Управление аккаунтом — Процессы задач — Стандартный — Кнопки — Новая кнопка.

! Обратите внимание, для новых пользователей ПланФикса, которые устанавливают коннектор после изменений и внедрения в ПланФикс сущности Объект, настройка кнопки производиться в Настройки / Управление аккаунтом / Объекты / Стандартный (или ваш Объект) / Кнопки / Нажимаем создать Новую кнопку.

Указываем название кнопки. 

В п. 3 выбираем кто видит кнопку и может на нее нажимать. 

В п. 5 выбираем послать HTTP запрос.

Далее интересно, будем копировать данные из настроек коннектора.

Возвращаемся на сайт getupd.io. Будем копировать вот эти данные.

Копируем URL и вставляем его в поле URL в ПланФикс. 

Теперь будем заполнять поле Содержимое запроса. Это значит, что нужно скопировать Параметр запроса  и затем найти его значение. Все по порядку. Заполненное поле у нас должно выглядеть так: 

У нас есть 6 параметров. task_id, customerPhone, customerEmail, vatCode, currency, paymentDescription. Каждый параметр у нас должен быть в отдельной строке, его вы можете просто скопировать. 

Для трех параметров переменную нужно указать согласно ваших настроек, это  task_id, customerPhone, customerEmail. 

vatCode — это цифровой параметр.

currency — это валюта RUB

paymentDescription — это Описание платежа.


Итак, первый параметр это task_id - это id задачи, 

В этом же блоке нажимаем Различные поля

у нас откроется список доступных переменных. Выбираем Задача и затем идентификатор.

Копируем переменную {{Задача.Идентификатор}} или нажимаем Вставить переменную. Только курсор должен стоять в поле для переменной т.е. в поле Значение. 

Далее, нажимаем Добавить, и ищем переменную для параметров customerPhone, customerEmail. 

и

Далее как на скриншоте 

Ваш vatCode. Если не знаете, переходите в настройки коннектора и кликаете по слову НДС

Вас перебросит на страницу ставок НДС.

У нас остается одна переменная указанная в настройках. Это itemDescription - Товар в чеке. Может использоваться вместо аналитики Товар.

Эту переменную нужно будет указать если у вас всего 1 товар. И значение ее может быть примерно таким: {{Задача.Название}}. 

Если товаров несколько, то ее не указываем. 

Отлично. Еще немного настроек и все будет работать 🙂

Нам осталось подставить Заголовки. Content-Type у нас указан, нажимаем Добавить. С настроек коннектора копируем и вставляем сам Заголовок Webhook-Token, затем его значение.

Для корректной работы ставим галочки. 

Сохраняем. Кнопка создана. 

Возвращаемся в настройки коннектора, будем выбирать параметры.

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

Вот так

Сохраняем.

Итак, если у вас 1 товар, услуга, разовые платежи, то можно не подключать Аналитики, и должна быть прописана переменная itemDescription при создании кнопки. В этом случае коннектор уже готов к работе🙂.


В случае, если у вас есть потребность давайте подключим Аналитики.

Переходим в ПланФикс, Настройки — Управление аккаунтом — Аналитики.

Создаем новую группу.

У меня это группа ЮКасса. И теперь в этой группе я создаю Аналитики по, например, по своим услугам.

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

У вас должно получиться вот так:

 

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

Отлично. Мы создали Аналитику!

Переходим к настройкам коннектора и заполним поля аналитик товара.

Для начала нужно выбрать Аналитику товара, и затем выбрать значения полей аналитик, выбранное значение соответствует названию поля слева.


При необходимости настраиваем время запуска коннектора.
Сохраняем.

Готово, мы подключили и настроили коннектор!


Как это работает.

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

Перехожу по ссылке 


О чудо

Давайте проверим статус в ПланФикс


А теперь мы воспользуемся Аналитиками.

Указываем сумму, нажимаем созданную кнопку.

Готово. 

Коннектор «ЮКасса» готов к работе.


С дополнительными вопросами по работе сервиса обращайтесь на почту mailbox@getupd.io или нажмите в личном кабинете на кнопку «Обратиться за помощью». Служба поддержки поможет разобраться с первичной настройкой коннекторов.


Вернуться назад