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

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

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

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

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

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

Где:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

У нас есть 11 параметров. task_id, customerPhone, customerEmail, vatCode, currency, paymentDescription, itemDescription, paymentMode, paymentSubject, paymentMethod, measure.

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

Обращаем внимание, что есть обязательные параметры и те, которые вы указываете при необходимости.

Для параметров переменную нужно указать согласно ваших настроек, для первых трех параметров подставляем переменную:

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

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

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

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

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

и

Оставшиеся параметры заполняем согласно ваших требований.

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

Пример заполнения:

Переменная itemDescription - Товар в чеке. Может использоваться вместо аналитики Товар.

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

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

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

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

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

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

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

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

Вот так:

Сохраняем.

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

! Обратите внимание:

При настройках коннектора Присутствует параметр measure - Мера количества предмета расчета

При настройке Полей аналитик товара присутствует Мера количества предмета. Этот параметр будет в приоритете.

Что это значит: Мера количества предмета - это сколько единиц товара, measure – это метры, сантиметры, тонны и проч. Если вы настраиваете параметр measure, то поле Мера количества предмета расчета должно быть Не задано.

В обратном случае, если в данном поле будет указано, например, Количество, то параметр measure не будет указан. Как пояснялось выше, Аналитики в приоритете.

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

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

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

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

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

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

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

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

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

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

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

Вебхук для отмены платежа

Итак, мы создали кнопку для оплаты. Для возврата платежа, мы создаем вторую кнопку.

Переходим Управление аккаунтом / Объекты / Кнопки и создаем кнопку, например Возврат платежа.

Указываем кто видит кнопку и может ее нажимать, при необходимости Текст на кнопке и цвет.

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

Копируем вебхук для отмены платежа, переходим в Планфикс, в настройки кнопки:

В п.5 выбираем Послать HTTP-запрос, вставляем вебхук в поле URL.

Содержимое запроса значение параметра task_id вставляем через различные поля по аналогии заполнения запроса при создании кнопки оплаты.

Заголовки копируем из настроек коннектора

Возвращаемся в настройки коннектора и указываем ваш URL возврата

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

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

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

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

Мы молодцы, коннектор работает.

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

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

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

Готово.

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

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