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

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

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

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

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

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

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

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

• Копіюємо 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 для спільного використання з іншим програмним забезпеченням.

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

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

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

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

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

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

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

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

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

• Тут додаємо помічник фільтр чи рахунок сплачено:

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

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

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

• Тепер можна активувати автоматизації.
  ​
  ​Загальний вид автоматизації після налаштувань:

---

Не знайшли відповідей, які шукали? Пишіть нам у чат підтримки прямо з CRM!А також доєднуйтесь до спільноти однодумців в нашому телеграм каналі.