IBAN oplata Довідка

Як підключити Sitniks

Після підключення Sitniks посилання на оплату зʼявляється в замовленні саме: менеджер переводить замовлення в статус, у якому ви просите оплату, Sitniks повідомляє про це IBAN oplata, і за кілька секунд у полі замовлення лежить готове посилання на суму замовлення з урахуванням знижки. У Sitniks для цього потрібна платна опція Open API, текстове поле замовлення й один вебхук; у кабінеті — майстер із чотирьох кроків.

Коли це потрібно

Одне посилання відповідає одному замовленню: якщо сума замовлення в Sitniks зміниться і замовлення знову перейде в той самий статус, сума посилання оновиться, а адреса лишиться тією самою. Якщо за посиланням уже оплатили, суму не змінюємо.

Підготувати Sitniks: Open API, токен і поле

  1. У Sitniks відкрийте Налаштування → Інтеграції і в самому низу списку оберіть Open API. Це платна опція Sitniks: без неї Sitniks не видасть токен.
  2. У вкладці «Open API» натисніть Додати інтеграцію — зʼявиться рядок із токеном. Скопіюйте його кнопкою праворуч.
  3. Відкрийте Налаштування вирв і замовлень, вкладку «Користувацькі поля замовлень», і натисніть Додати поле. Тип — «Текст», назва — будь-яка зручна вам, наприклад «Посилання на оплату IBAN». Обовʼязковим поле не робіть.

Типу «Посилання» в Sitniks немає, тож посилання ляже в текстове поле: клікабельним воно не буде, але його можна скопіювати. Токен дає доступ до замовлень, тож не пересилайте його в месенджерах. IBAN oplata зберігає токен зашифрованим і показує лише 4 останні символи.

Підключити Sitniks у кабінеті

  1. У меню акаунта оберіть Підключення CRM. На картці Sitniks натисніть Підключити. Відкриється вікно «Підключити Sitniks».
  2. На кроці «Токен Open API» вставте токен у поле Токен Open API і натисніть Далі. Ми перевіримо токен запитом до Sitniks і завантажимо статуси й текстові поля замовлень.
  3. На кроці «Статус і поле» оберіть Статус для створення посилання: коли замовлення перейде в цей статус, ми автоматично створимо посилання на оплату. Можна вибрати «В обробці» або створити окремий статус для оплати в Sitniks.
  4. Там само в Поле для збереження посилання оберіть поле замовлення, у якому зʼявиться посилання, і натисніть Далі. Не бачите потрібного поля — створіть його в Sitniks і натисніть Оновити список.
  5. На кроці «Посилання на оплату» налаштовується посилання, яке ми створюватимемо для кожного замовлення. Оберіть Реквізити, на які прийматимете оплату, і перевірте Призначення платежу: під полем видно, як його прочитає покупець. Галочки Додати номер замовлення із Sitniks і Додати імʼя покупця із Sitniks додають у текст номер замовлення й імʼя покупця — їх ми підставимо з кожного замовлення.
  6. Натисніть Зберегти. Зʼявиться «Налаштування збережено. Залишилось додати вебхук у Sitniks, щоб посилання на оплату створювалися автоматично.» і адреса вебхука.

Термін дії посилань із Sitniks — той, що вказаний у налаштуваннях кабінету для нових посилань.

Налаштувати вебхук у Sitniks

Вебхук — це запит, яким Sitniks повідомляє IBAN oplata про зміну статусу замовлення. Без нього підключення лишається в стані «Очікуємо перший виклик».

  1. Скопіюйте адресу вебхука кнопкою копіювання поруч із нею — на останньому кроці майстра або в рядку Адреса вебхука на картці підключення. Зʼявиться повідомлення «Адресу вебхука скопійовано».
  2. У Sitniks відкрийте Налаштування → Інтеграції → Open API → вкладка «Webhooks» і натисніть Додати вебхук.
  3. Виберіть подію «Статус замовлення оновлено», вставте скопійовану адресу в поле Url і натисніть Створити.
  4. Перевірте підключення: переведіть тестове замовлення в статус, обраний у майстрі, — посилання зʼявиться в полі, яке ви обрали.
  5. Забули кроки — у меню картки підключення оберіть Як налаштувати вебхук.

На кожну подію Sitniks дозволяє лише одну адресу. Якщо після Створити Sitniks відповідає «Вебхук вже існує», подію «Статус замовлення оновлено» вже отримує інший сервіс. Перш ніж замінювати його адресу нашою, переконайтеся, що вона не потрібна іншій інтеграції: після заміни та перестане отримувати оновлення замовлень. Події «Повідомлення в чаті» й «Зміна статусу чату» на нашу адресу не додавайте.

Журнал подій і «Повторити»

Під карткою підключення — «Журнал подій»: останні 50 подій за 30 днів. Кожен рядок каже, яке замовлення прийшло, що сталося з посиланням і чи записали ми його в Sitniks. Зміни в інші статуси, крім обраного, у журнал не потрапляють.

  1. Усуньте причину (замініть токен, оберіть інше поле) і натисніть Повторити в рядку події. Ми заново прочитаємо замовлення з Sitniks — зі свіжою сумою — і запишемо посилання. У журналі зʼявиться новий рядок.

Записуючи посилання, ми не чіпаємо інших полів замовлення: усі ваші користувацькі поля лишаються як були.

Змінити підключення

  1. Змінити над карткою підключення відкриває кроки «Статус і поле» і «Посилання на оплату» з поточними значеннями. Натисніть Зберегти — зʼявиться «Зміни збережено».
  2. У меню картки Замінити токен — вставте новий токен і натисніть Зберегти. Статус, поле, реквізити й адреса вебхука лишаються як були.
  3. У меню картки Створити нову адресу вебхука — натисніть Створити. Поточна адреса перестане працювати одразу, тож вставте нову у вебхук «Статус замовлення оновлено» в Sitniks.
  4. У меню картки Відключити — натисніть Відключити. Створені посилання й надалі працюватимуть, адреса вебхука перестане приймати виклики, а токен ми видалимо. Видаліть вебхук у Sitniks: інакше нова інтеграція не зможе додати свою адресу на ту саму подію.

Підключення «Призупинено»

Якщо ми не можемо створювати чи записувати посилання, підключення стає «Призупинено», а на пошту приходить один лист. Іконка попередження поруч зі статусом пояснює причину:

Якщо щось не так

Оновлено Відкрити як Markdown