Для подключения коннектора необходимо подключить Аккаунт ПланФикс. Как это сделать смотрим по ссылке.
Видео инструкция подключения и настройки коннектора доступна по ссылке.
Далее необходимо подключить сервис ЮКасса на сайте getupd.io вкладка Аккаунты.
Нажимаем Добавить и переходим в настройки,
Где:
Название — произвольное название подключения.
ID магазина — ID вашего магазина на сайте yookassa.ru
API ключ — API ключ на сайте yookassa.ru
Подключив аккаунт Юкасса, переходим во вкладку Коннекторы, Создать коннектор.
Для этого, при создании объекта, нажимаем на “+”. И после появления списка, снова нажимаем на “+”.
Если данные поля у вас созданы, выберете их из списка.
В открывшихся настройках указываем название.
Обратите внимание - при создании нового поля в шаблоне есть параметр "Тип поля". Для полей Платежная ссылка и Статус оплаты - тип поля можно не менять, по умолчанию будет Строка.
Для поля Сумма платежа тип поля - число.
! При создании поля Платежная ссылка, советую перевести триггер Отображать как гиперссылку в состояние Включен и выбрать https протокол.
Итак, теперь, после создания, в объекте у нас отображаются данные поля.
Теперь нам нужно создать шаблон для данного объекта.
Переходим в Задачи / Шаблоны / Новый шаблон задачи.
При создании нового шаблона, нужно выбрать, на основе какого объекта будет создан новый шаблон. Выбираем ваш объект.
Интерфейс аккаунтов может различаться, в первом случае мы выбираем "На основе шаблона":
Во втором варианте привязка шаблона осуществляется через маленькую стрелочку:
Итак, у нас создан новый шаблон задачи для нового объекта
Теперь, в данном шаблоне отображаются новые поля, необходимые для настройки коннектора.
Теперь будем создавать кнопку.
В ПланФикс переходим в Настройки — Управление аккаунтом — Объекты — Юкассса (Ваш объект) — Кнопки — Новая кнопка.
Указываем название кнопки.
Так как кнопку мы создаем в определенном объекте, отображаться она будет, только в задачах, созданных в этом объекте, он проставляется автоматически.
Возвращаемся на сайт 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.
Вас перебросит на страницу ставок НДС.
У нас остается одна переменная указанная в настройках. Это itemDescription - Товар в чеке. Может использоваться вместо аналитики Товар.
Эту переменную нужно будет указать если у вас всего 1 товар. И значение ее может быть примерно таким: {{Задача.Название}}.
Если товаров несколько, то ее не указываем.
Отлично. Еще немного настроек и все будет работать 🙂
Нам осталось подставить Заголовки. Content-Type у нас указан, нажимаем Добавить. С настроек коннектора копируем и вставляем сам Заголовок Webhook-Token, затем его значение.
Для корректной работы ставим галочки.
Сохраняем. Кнопка создана.
Возвращаемся в настройки коннектора, будем выбирать параметры.
Первым делом выбираем тот шаблон, в котором мы создали новые поля. У меня шаблон так и называется ЮКасса. Как только я его выбрала, можно настроить Поля шаблона. Название Поля слева, должно соответствовать выбранному значению.
Вот так
Сохраняем.
Итак, если у вас 1 товар, услуга, разовые платежи, то можно не подключать Аналитики, и должна быть прописана переменная itemDescription при создании кнопки. В этом случае коннектор уже готов к работе🙂.
В случае, если у вас есть потребность давайте подключим Аналитики.
Переходим в ПланФикс, Настройки — Управление аккаунтом — Аналитики.
Создаем новую группу.
У меня это группа ЮКасса. И теперь в этой группе я создаю Аналитики по, например, по своим услугам.
В этой аналитике мне нужно создать поля, которые мы впоследствии, выберем в настройках коннектора. Это поля: название товара, количество и цена.
У вас должно получиться вот так:
Обратите внимание, обязательно укажите корректный тип поля, и советую перевести триггер в положение Обязательный для заполнения.
Отлично. Мы создали Аналитику!
Переходим к настройкам коннектора и заполним поля аналитик товара.
Для начала нужно выбрать Аналитику товара, и затем выбрать значения полей аналитик, выбранное значение соответствует названию поля слева.
При необходимости настраиваем время запуска коннектора.
Сохраняем.
Готово, мы подключили и настроили коннектор!
Как это работает.
Проверим. Я создала задачу Платеж. Указала сумму, нажала на созданную кнопку. У меня отобразилась гиперссылка, и статус Ожидании оплаты.
Перехожу по ссылке
О чудо
Давайте проверим статус в ПланФикс
А теперь мы воспользуемся Аналитиками.
Указываем сумму, нажимаем созданную кнопку.
Готово.
Коннектор «ЮКасса» готов к работе.
С дополнительными вопросами по работе сервиса обращайтесь на почту mailbox@getupd.io или нажмите в личном кабинете на кнопку «Обратиться за помощью». Служба поддержки поможет разобраться с первичной настройкой коннекторов.