Перейти до основного контенту

Інтеграція з платіжним сервісом àбанк

З цієї статі ви дізнаєтесь як створювати рахунки і автоматично фіксувати оплати у картці клієнта в CRM

Оновлено понад місяць тому

Що треба для успішної роботи з боку àбанк

Вам потрібно бути користувачем àбанк, або зареєструватись.
Також радимо ознайомитись з послугою "Еквайринг" та її ціновою політикою.

Якщо у вас вже все готово, то виконайте наступні кроки:

  • Переходимо в застосунок àбанк обираємо "Послуги Бізнесу".

  • Далі "Еквайринг" --> та "додати магазин/сайт".

  • Ставимо відмітку біля "Інтернет - еквайринг" --> Далі.

  • Заповнюємо всю потрібну інформацію та "Оформити заявку"​

  • Після цього вам надійде пуш - сповіщення з потрібною інформацією:

  • Копіюємо Login та Secret key.

  • Та переходимо до налаштувань в Nethunt CRM.

Налаштовуємо додаткові поля в Nethunt CRM

Вам потрібно створити додаткові (технічні) поля які будуть відправляти інформацію в àбанк і отриману відповідь збиратимуть в картку клієнта, або надсилати посилання вашому клієнту для оплати.

Створюємо окрему групу полів:

  • Додаємо поле типу чекбокс (це буде ваш тригер).

  • Поле "URL", в нього буде повертатись посилання на рахунок.

  • "Сума" - це числове поле в якому треба буде вказувати ціну послуги.

  • Поле "Назва товару/послуги" це звичайний однорядковий текст.

  • І за потребою можна вказати "Опис" - це багаторядкове поле.

  • Також повинно бути поле, яке будемо використовувати як правило дублікації - це теж звичайний однорядковий текст.

💡Зверніть увагу: Останнє текстове поле необхідно вказати в розділі - налаштування визначення дублікатів.

  • Додатково створимо "Випадаюче меню" з пресетами - "Сплачено" та "Неуспішно":


Будуємо автоматизацію

Для того, щоб ви могли інформацію відправити в àбанк, вам потрібно створити автоматизацію:

  • Тригер автоматизації буде значення поля змінено і обираємо поле чекбокс (якщо ви обрали інше поле як тригер, то вкажіть його):

  • Далі потрібно зробити API виклик для отримання токену:

Додайте деталі API виклику, де:

  1. Виберіть тип запиту - POST

  2. URL - це вебхук, взятий із програмного забезпечення, до якого ви хочете надіслати інформацію, а саме з банку:

    https://qr-acquiring-release.a-bank.com.ua/api/v1/internet-acquiring/auth/get-token

  3. JSON - дані для надсилання за допомогою формату даних JavaScript Object Notation. Скопійовані login та secret key вставляємо тут:

    {
    "login": "****",
    "secret_key": "****"
    }

  4. Заголовки - Accept, application/json.

  • Зберігаємо та робимо тестовий запит, щоб отримати відповідь 200:

  • Після того, як ви отримали відповідь та потрібний токен, додаємо другий API виклик:

Додайте деталі API виклику, де:

  1. Виберіть тип запиту - POST

  2. URL - це вебхук, взятий із програмного забезпечення, до якого ви хочете надіслати інформацію, а саме з банку:

    https://qr-acquiring-release.a-bank.com.ua/api/v1/internet-acquiring/make-invoice

  3. JSON - дані для надсилання за допомогою формату даних JavaScript Object Notation

    {
    "amount": "Макрос сума",
    "communication_uuid": "Макрос Id запису - Макрос мітка часу",
    "items": [
    {
    "message": "Макрос Назва товару/послуги",
    "amount": Макрос сума,
    "count": 1 <--(кількість) Макрос або конкретне значення для всіх викликів
    }
    ],
    "callback_url": "https://a-bank.com.ua/business/acquiring",
    "description":"Макрос Оплата послуг",
    "callback_system": "Посилання вебхука для відповіді",
    "payload": {
    "key_event_title": "Макрос Id запису"
    }
    }

  4. Заголовки - Accept, application/json, Authorization та Bearer Аccess_token.

  5. Макроси - значення полів, які ви вибираєте з NetHunt для спільного використання з іншим програмним забезпеченням.

💡Зверніть увагу: "callback_system" в API виклику, це значення яке ми трохи нижче розберемо і додамо "Підтвердження оплати на вебхук".

  • Далі вам треба зробити тест, щоб ви отримали посилання на цей рахунок. Ви можете активувати автоматизацію, перейти в тестову картку, заповнити всі поля і натиснути чекбокс (або інше поле яке відповідає за це). Після того як автоматизація відпрацювала, натискаємо "Змінити автоматизацію":

  • Додаємо дію "Оновити запис" і вказуємо наше поле "Посилання на рахунок" вказуємо макрос - "Invoice Url", та в поле "Id запису" вказуємо макрос - "Id запису":

  • Тепер все готово можна активувати автоматизацію або додати дію відправити клієнту посилання на пошту.

  • Також як виглядає повернутий URL в картці клієнта:

Підтвердження оплати на вебхук

Після того як клієнт вже оплатив рахунок, ви можете отримати відповідь на вебхук, який ми вказуємо в той момент коли створюємо цей рахунок. (Див. Будуємо автоматизацію):

Створюємо ще одну автоматизацію, яка буде мати тригер "відбулась вебхук подія", та переносимо наш URL в API виклик:

  • Тепер нам треба зробити тестовий запит та оплату рахунку, щоб вебхук отримав потрібні поля як відповідь (натисніть "Оновити поля") і далі з ними можна було працювати.

  • Додаємо дію створити запис і вказуємо унікальне значення з картки угоди, щоб оплата оновила саме ту картку яку потрібно (правило дублікації).

  • Гілка Так: в нас буде оновлювати запис як сплачений:

  • Гілка Ні: як оплата не пройшла:

  • Можливо також додати задачу на відповідального, щоб він додатково зв'язався з клієнтом і дізнався з приводу оплати.

  • Тепер можна активувати автоматизації.

    Загальний вид автоматизації після налаштувань:

💡Зверніть увагу: Це лише приклад подібної автоматизації. Ви можете створити власні поля і назви до них та налаштувати інший подібний сценарій - ланцюжок для автоматизації.


Не знайшли відповідей, які шукали? Пишіть нам у чат підтримки прямо з CRM!

А також доєднуйтесь до спільноти однодумців в нашому телеграм каналі.


Ви отримали відповідь на своє запитання?