Перейти до змісту

Для інтернет-магазинів в Україні

Чекаут з оплатою monobank і накладною Нової Пошти

Покупець вводить контакти й відділення та платить через monobank. Ви отримуєте оплачене замовлення, webhook на свій сервер і ТТН — в одному кабінеті.

Гроші надходять напряму на ваш рахунок monobank.

Як це працює

  1. 1

    Магазин передає кошик

    Скрипт у темі Shopify або запит з вашого сервера створює сесію й повертає посилання на чекаут.

  2. 2

    Покупець оформлює й платить

    Вводить контакти, обирає місто й відділення Нової Пошти або доставку за кордон і платить через monobank.

  3. 3

    Ви отримуєте замовлення

    Замовлення з’являється в кабінеті, ваш сервер отримує підписаний webhook, а ТТН створюється однією кнопкою.

Переваги

Harno Pay не замінює еквайринг. Він збирає оплату, доставку й замовлення в один потік, щоб ви не переносили дані між сервісами вручну.

  • Гроші одразу на ваш рахунок

    Кожен магазин підключає власний токен monobank. Harno Pay не є еквайром і не тримає кошти.

  • Коротке оформлення

    Пошук міста й відділення Нової Пошти просто у формі, доставка за кордон за зонами, які ви задаєте самі.

  • Накладна без ручного введення

    ТТН створюється з даних замовлення, етикетка 100×100 друкується з кабінету, статус посилки оновлюється сам.

  • Замовлення не загубиться

    Якщо ваш сервер не відповів, webhook повториться до 8 разів з наростаючими паузами. Журнал і ручний повтор — у кабінеті.

  • Працює з будь-яким сайтом

    Shopify підключається скриптом у темі, інші сайти — через універсальний API. Суми рахуються на сервері.

  • Усе в одному кабінеті

    Оплата, доставка, Нова Пошта й інтеграція — у вкладках кабінету. Замовлення, webhook і ТТН — в одному списку.

Інтеграції

Shopify

Скрипт у theme.liquid перехоплює кнопку оформлення й передає кошик у Harno Pay. Після оплати замовлення створюється у вашому Shopify. Підключення через custom app вашого магазину.

Працює

Універсальний API

Для самописних сайтів і будь-яких платформ: ваш сервер створює сесію запитом з секретним ключем і відправляє покупця за посиланням на чекаут.

Працює

Скоро

  • Фіскальні чеки ПРРО (Вчасно Каса)
  • Модулі WooCommerce, OpenCart, Horoshop, Prom
  • Повернення з кабінету
  • Сповіщення покупцю
  • Підтвердження володіння сайтом
У розробці

Підключення

  1. 1

    Реєстрація

    Email, пароль і адреса сайту. Перевіряємо, що сайт відкривається з інтернету й не закритий від індексації.

  2. 2

    Токен monobank

    web.monobank.ua → Еквайринг → API-токен. Вставте його у вкладці «Оплата», там же адреса webhook для mono.

  3. 3

    Нова Пошта

    Ключ API з кабінету Нової Пошти, місто й відділення відправки, телефон і вага посилки за замовчуванням.

  4. 4

    Інтеграція

    Скрипт для теми Shopify або API-ключ для вашого сервера, адреса webhook і секрет підпису.

Створення сесії з вашого сервера
curl -X POST https://pay.harnopay.online/api/v1/sessions \
  -H "Authorization: Bearer gp_..." \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "title": "Худі", "variantTitle": "Графіт / L",
        "sku": "HD-01-L", "price": 189900, "quantity": 1,
        "image": "https://..."
      }
    ],
    "reference": "order-1001",
    "returnUrl": "https://shop.example/thanks",
    "cancelUrl": "https://shop.example/cart"
  }'
Webhook order.paid після оплати
{
  "event": "order.paid",
  "id": "...",
  "number": 12,
  "reference": "order-1001",
  "currency": "UAH",
  "total": 259700,
  "shippingPrice": 7000,
  "lines": [
    { "title": "Худі", "variantTitle": "Графіт / L",
      "sku": "HD-01-L", "price": 189900, "quantity": 1 }
  ],
  "customer": { "firstName": "...", "lastName": "...",
                "phone": "+380...", "email": "..." },
  "delivery": { "method": "nova_poshta_warehouse",
                "price": 7000, "...": "..." },
  "paidAt": "2026-11-04T12:00:00.000Z"
}

Повна інструкція з підключення

Питання й відповіді

Хто отримує гроші покупця?

Ви. Оплата проходить через monobank acquiring за вашим токеном, і кошти зараховуються на ваш рахунок. Harno Pay не є еквайром, не тримає кошти й не замінює договір еквайрингу — він поєднує оплату, доставку й замовлення в один потік.

Що потрібно для підключення?

Підключений інтернет-еквайринг monobank і його API-токен, ключ API Нової Пошти для накладних і доступ до сайту: тема Shopify або сервер, з якого можна надіслати запит до API.

Скільки часу займає підключення?

Залежить від платформи. Для Shopify треба створити custom app у магазині й вставити один рядок у тему. Для власного сайту розробнику потрібно додати запит на створення сесії та обробник webhook.

Скільки коштує сервіс?

Умови уточнюються при підключенні. Напишіть нам — розповімо, як це працює для вашого магазину.

Які платформи підтримуються?

Зараз — Shopify і будь-який сайт через універсальний API. Готові модулі для WooCommerce, OpenCart, Horoshop і Prom у розробці.

Що з поверненнями й фіскальними чеками?

Повернення з кабінету та фіскальні чеки ПРРО через Вчасно Касу ще в розробці. Поки що ці операції ведуться поза Harno Pay.

Як захищені токени й ключі?

Токени monobank і Shopify, ключ Нової Пошти та секрет webhook зберігаються зашифрованими. API-ключ показується один раз, у базі лежить лише його хеш. Ключ Нової Пошти не потрапляє в браузер: етикетка друкується через наш сервер.

Що буде, якщо webhook не дійшов?

Якщо ваш сервер відповів не 2xx, не встиг за 10 секунд або був недоступний, ми повторимо доставку до 8 разів: через 1 хв, 5 хв, 30 хв, 2 год, 6 год, 12 год і 24 год. Статус і час наступної спроби видно в кабінеті, там же можна повторити вручну. Замовлення при цьому вже збережене.

Контакти

Напишіть, щоб підключити магазин, уточнити умови або поставити питання про інтеграцію. Розкажіть, на якій платформі ваш сайт — так відповідь буде предметнішою.