Створіть адаптер Hutko
У Налаштування → Розробникам → Адаптери оберіть Hutko, введіть ID мерчанта та ключ оплати в окремих полях і натисніть «Створити».
Інтеграція Hutko синхронізує результати оплат вашого бізнесу з Obriym CRM. Карткові дані й кошти залишаються у Hutko: після оплати сервіс надсилає захищене серверне повідомлення, а CRM перевіряє Merchant ID і SHA1-підпис перед записом.
Як проходить оплата
CRM перевіряє повідомлення Hutko, зберігає платіж і відразу показує, чи вдалося повʼязати його із замовленням.
Підписаний callback
Hutko надсилає результат платежу на унікальну адресу вашої інтеграції.
Перевірка мерчанта
merchant_id у callback має збігатися з налаштованим мерчантом Hutko.
Запис платежу
CRM зберігає фактичну суму й валюту у журналі оплат та не вигадує замовлення лише з факту платежу.
Звірка
Повністю оплачене наявне замовлення може перейти у статус «Підтверджено»; неповʼязана оплата лишається у журналі.
Технічний контракт
Налаштовується в Налаштування → Розробникам → Адаптери.
- CRM endpoint
- POST /api/v1/adapters/hutko/{configId}
- Credentials
- {"merchantId":"1703986","password":"..."}
- Підпис
- SHA1 за відсортованими непорожніми полями callback із password мерчанта
- Збережені дані
- замовлення, статус платежу, сума, валюта, provider ids, optional email/phone покупця
Модель безпеки
- Відхиляє callback для іншого merchant_id
- Відхиляє непідписані або неправильно підписані payload
- Не зберігає PAN, CVV або raw card tokens
- Редагує чутливі Hutko metadata перед збереженням діагностики
- Необовʼязкова локальна перевірка тестує збережені дані й підпис без створення оплати
CRM реєструє результат, а не керує оплатою
CRM приймає статуси created, processing, approved, declined, expired і reversed та записує фактично списану суму й валюту. Якщо order_id збігається з наявним замовленням, оплата прикріплюється до нього; без збігу вона потрапляє у «Комерція → Оплати» для звірки. Інтеграція не створює замовлення чи платіжні посилання, не списує й не повертає кошти та не зберігає PAN, CVV або токен картки.
Налаштування
Вставте URL у порталі Hutko
Для всіх оплат мерчанта: Налаштування мерчанта → Налаштування платежів → URL колбеку сервера. Для окремого посилання: Платіжні рішення → Платіжні посилання → Розширені функції → URL колбеку сервера. Значення посилання замінює значення мерчанта.
Або передайте URL через API
Якщо checkout створює ваш сайт або backend, передавайте згенерований URL як server_callback_url у кожному запиті.
Проведіть контрольну оплату
Локальна перевірка зʼєднання необовʼязкова. Щоб перевірити налаштування саме вашого кабінету Hutko, проведіть оплату з новим order_id та знайдіть її у «Комерція → Оплати»; для наявного замовлення передайте його externalId.
Часті запитання
Це та сама інтеграція Hutko, яка оплачує підписки Obriym?
Ні. Ця інтеграція потрібна для оплат ваших покупців. Оплата тарифів самого Obriym працює окремо й не змішується з вашим журналом оплат.
Чи керує цей adapter рекурентними платежами?
Ні. Інтеграція лише фіксує повідомлення про результат. Платіжна сторінка, списання, повернення та рекурентні платежі залишаються у Hutko.
Що якщо Hutko не передає email покупця?
Платіж усе одно записується. Email або телефон покупця зберігаються лише тоді, коли Hutko справді передає ці дані; у безпечному журналі діагностики видно лише наявність полів, але не їхні значення.
Чи створить callback замовлення?
Ні. Якщо order_id збігається з externalId наявного замовлення, оплата прикріпиться до нього. Інакше вона збережеться окремо для звірки.
Де в порталі Hutko знаходиться поле callback?
Глобально: Налаштування мерчанта → Налаштування платежів → URL колбеку сервера. Для конкретного платіжного посилання відкрийте його Розширені функції; URL там замінює глобальне значення.
Підключіть статуси оплат Hutko
Фіксуйте підтверджені оплати Hutko й звіряйте їх із замовленнями без ризику створити дубль.
Почати безкоштовно