Кнопка з функцією Оплата спрощує роботу з підключеними платіжними системами, надаючи посилання для оплати.

картинка

Зверніть увагу, що в багатьох месенджерах посилання можна розміщувати лише в інлайн-кнопках у тексті. Не забудьте вибрати відповідний тип кнопки в налаштуваннях блоку після її створення.

Кнопка з функцією Оплата доступна для таких платіжних систем:

  • Stripe

В межах одного блоку можна створювати кнопки Оплата для різних платіжних систем з різними сумами оплати.

Якщо до проєкту не підключено жодної платіжної системи, цей тип кнопки буде недоступний.

картинка

Основні поля кнопки Оплата:

  • Текстове поле: Цей текст буде відображатися на кнопці з посиланням на оплату в повідомленні.
  • Функція: Виберіть тип кнопки Оплата.
  • Поле функції: Щоб створити кнопку, яка надає посилання для оплати, виберіть функцію Оплата.
  • Поле платіжної системи: У списку відображаються платіжні системи, підключені до проєкту.

Залежно від обраної платіжної системи, обов'язкові поля для генерації посилання та створення чека будуть відрізнятися.

Ви можете переглянути налаштування кнопки з функцією Оплата для різних платіжних систем тут:

Обов'язковими полями для генерації посилання на оплату є Сума та Назва товару/Опис товару.

  • Поле Сума: Введіть суму оплати тут.
  • Поле Назва товару: Введіть назву товару, яка буде відображатися на сторінці оплати.

Подвійні лапки не можна використовувати в назві товару.

Ви можете замінити їх на апострофи або одинарні лапки.

Залежно від обраної платіжної системи, в налаштуваннях кнопки з'являться випадаючі меню Дані для чека та/або Додаткова інформація. Натискання на них відкриє додаткові поля:

картинка

Змінні при використанні кнопки з функцією Оплата

Як тільки користувач отримує блок з кнопкою Оплата, автоматично створюються такі змінні клієнта:

  • Системна змінна клієнта __payments – ця змінна зберігає суму оплати та ідентифікатор згенерованого посилання на оплату. Вона використовується для ідентифікації відповіді вебхука від платіжної системи.

Системну змінну клієнта __payments не можна видаляти або змінювати!

Змінна клієнта error_payment_button створюється, якщо під час генерації кнопки оплати виникає помилка.

Її значення міститиме або повідомлення про помилку, або відповідь з помилкою, повернуту платіжною системою.

Значення змінних стають активними (актуальними), коли користувач переходить до наступного блоку.

Як обробити результат

Успішна оплата

Після успішної оплати бот отримає зворотний виклик, що складається з перших 10 символів секретного ключа платіжної системи, слова _success та суми оплати, розділених пробілом. Наприклад: ovg58keefc_success 44, де:

  • ovg58keefc: перші 10 символів секретного ключа платіжної системи
  • _success: вказує на результат запиту (успішна оплата)
  • 44: сума оплати

Зворотні виклики (сповіщення) від платіжної системи не видимі для користувача. Вони відображаються лише на вкладці Клієнти та видимі оператору.

Приклад використання: Крок 1. У блоці з кнопкою Оплата додайте кнопки з функцією Оплата. Крок 2. У полі Умова переходу з цього блоку до блоку Успішна оплата вкажіть зворотний виклик. Це працює так само, якщо ви вкажете зворотний виклик успішної оплати в полі Умова блоку Перевірка первинної умови.

Зверніть увагу! Вибір типу збігу — Точний збіг або Збіг за ключовим словом.

Корисна порада

Щоб надіслати клієнту сповіщення про успішну оплату, не перериваючи його проходження основною воронкою, створіть "Нестатусні блоки з умовами."

Оплата з помилкою

Якщо виникає помилка оплати, бот отримає зворотний виклик, що складається з перших 10 символів секретного ключа платіжної системи, слова _fail та суми оплати, розділених пробілом. Наприклад: ovg58keefc_fail 44, де:

  • ovg58keefc: перші 10 символів секретного ключа платіжної системи
  • _fail: результат обробки запиту — оплата не вдалася або сталася помилка
  • 44: сума оплати

Це залежить від платіжної системи. Не всі платіжні системи надсилають зворотний виклик про помилки оплати.

Якщо сума, вказана в налаштуваннях кнопки, відрізняється від фактично сплаченої клієнтом суми, бот отримає зворотний виклик, що складається з перших 10 символів секретного ключа платіжної системи, фрази _different_amounts та унікального ідентифікатора платежу, розділених пробілом. Наприклад: ovg58keefc_different_amounts 123456, де:

  • ovg58keefc: перші 10 символів секретного ключа платіжної системи
  • _different_amounts: результат обробки запиту (сума оплати відрізняється від суми в посиланні)
  • 123456: унікальний ідентифікатор платежу