Створіть Hutko adapter
У Налаштування → Розробникам → Адаптери оберіть Hutko і збережіть merchant credentials як JSON.
Hutko підключено як adapter синхронізації статусів оплат для workspace. CRM не обробляє картки і не тримає кошти: Hutko проводить оплату, а потім надсилає підписаний server callback в Obriym CRM. Adapter перевіряє merchant id і SHA1-підпис перед будь-яким записом платежу.
Потік callback
Adapter навмисно вузький: прийняти, перевірити, записати і оновити замовлення.
Підписаний callback
Hutko надсилає результат платежу на згенерований endpoint adapter.
Перевірка мерчанта
merchant_id у callback має збігатися з налаштованим мерчантом Hutko.
Запис платежу
CRM створює або оновлює crm_order_payments зі статусом, сумою, валютою і provider payment id.
Статус замовлення
Оплачений callback може перевести pending-замовлення в confirmed через спільний payment flow.
Технічний контракт
Налаштовується в Налаштування → Розробникам → Адаптери.
- 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 перед збереженням діагностики
- Connection test перевіряє credential JSON і локальну перевірку підпису без створення payment rows
Межі перевірки зʼєднання
Перевірка налаштування Hutko — це безпечна локальна self-check перевірка credentials і підпису. Live-ready стан підтверджується тим, що Hutko доставляє реальний підписаний callback на згенерований endpoint.
Налаштування
Скопіюйте callback URL
Використайте згенерований server callback URL у налаштуваннях мерчанта Hutko або у вашій checkout-інтеграції.
Запустіть перевірку
Використайте Test connection і sandbox validation перед реальним платежем клієнта.
Часті запитання
Це та сама інтеграція Hutko, яка оплачує підписки Obriym?
Ні. Цей adapter потрібен для власних замовлень і покупців workspace. Billing самого Obriym — окремий subsystem.
Чи керує цей adapter рекурентними платежами?
Цей adapter фіксує payment callbacks. Повне керування підписками клієнтів workspace треба додавати окремим product flow після явного контракту з Hutko.
Що якщо Hutko не передає email покупця?
Платіж все одно записується. Adapter зберігає email або телефон покупця лише якщо вони є у підписаному callback.
Підключіть статуси оплат Hutko
Нехай платіжний провайдер підтверджує результат, а CRM тримає історію оплат замовлення консистентною.
Почати безкоштовно