Как подключить и настроить коннектор «ЮКасса» через Объекты



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

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

Далее необходимо подключить сервис ЮКасса на сайте 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 или нажмите в личном кабинете на кнопку «Обратиться за помощью». Служба поддержки поможет разобраться с первичной настройкой коннекторов.

  

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