Документація

• Створення рахунків та платіжних посилань за лічені секунди
• Підтримка 30+ банківських додатків (monobank, Приват24, ПУМБ та ін.)
• Вибір додатку банку клієнтом на сторінці оплати
• QR-код для швидкої оплати з телефону
• Повноцінний особистий кабінет
• Прив’язка кількох компаній (ФОП / ТОВ / ПП / ГО чи ін.)
• Кілька мерчантів (магазинів / проєктів / напрямів діяльності) в одній компанії
• REST API для автоматизації (створення рахунків, перевірка статусів на платних тарифах)
• Нульова комісія за транзит платежів
• Безкоштовний тариф

Після входу ви потрапляєте на Панель керування.

Основні розділи лівого меню:

• Панель керування - загальна статистика за місяць
  • Кількість створених рахунків
  • Сума успішних оплат за місяць
  • Очікувані платежі (неоплачені рахунки)
• Мої компанії - список ваших юридичних осіб / ФОП Прив’язуйте необмежену кількість компаній → кожна може мати власні IBAN-и та мерчантів.
• Мерчанти - проєкти / напрямки всередині компанії Кожен мерчант має:
  • власну назву та опис
  • логотип та колір бренду
  • прив’язаний IBAN
  • статистику платежів окремо
• Рахунки - повний список усіх створених рахунків (фільтри за статусом, мерчантом, сумою)
• Новий рахунок - швидке створення платежу Поля: сума, призначення, термін дії, мерчант
• API ключ - розділ для генерації ключів та ознайомлення з документацією API (на платних тарифах)
• Налаштування - профіль, зміна тарифу та ін.

1. Зареєструйтесь за 1 хвилину
2. Додайте компанію (ФОП / ТОВ / інше)
   • Вкажіть назву, код ЄДРПОУ/ІПН
   • Додайте IBAN рахунки компанії
3. Створіть мерчант
   • Виберіть компанію
   • Прив’яжіть IBAN (рахунок, на який приходитимуть гроші)
   • Вкажіть назву бізнесу, опис, логотип (опціонально)
4. Перейдіть у Новий рахунок або скористайтеся API
5. Після створення рахунку клієнт ви отриммаєте посилання виду https://pay24.com.ua/pay/xxxxxxxx
6. Клієнт відкриває посилання → обирає банк → підтверджує платіж у своєму додатку
7. Гроші надходять на ваш IBAN 

Base URL: https://api.pay24.com.ua/v1

Формат даних: JSON (Content-Type: application/json)

Кодування: UTF-8

Протокол: тільки HTTPS

Використовується Bearer Token.

Токен потрібно передавати в заголовку (Header):

Authorization: Bearer YOUR_API_KEY

YOUR_API_KEY - ваш ключ API, який генерується в особистому кабінеті в розділі API ключ.

Формат API ключа: p24live_[32 hex символи]

• Один ключ на акаунт
• Доступ тільки до ваших мерчантів

Тіло запиту (JSON)

Приклад запиту

POST /v1/invoices HTTP/1.1
Host: api.pay24.com.ua
Authorization: Bearer p24live_...
Content-Type: application/json

{
  "merchant": 12345,
  "amount": 1400.00,
  "purpose": "Рахунок №12345 за послуги",
  "expires": "2027-03-31"
}

Успішна відповідь (201 Created)

{
  "id": "a3f9b2c1Kx",
  "url": "https://pay24.com.ua/pay/a3f9b2c1Kx",
  "merchant": 12345,
  "amount": 1400.00,
  "currency": "UAH",
  "purpose": "Рахунок №12345 за послуги",
  "status": "active",
  "expires_at": "2027-03-31 00:00:00",
  "created_at": "2025-04-01T14:22:00Z"
}

Відповідь з помилкою (403 Not allowed)

{
  "error": "Merchant not found or does not belong to your account"
}

{id} — значення поля id з відповіді створення

Приклад запиту

GET /v1/invoices/a3f9b2c1Kx HTTP/1.1
Host: api.pay24.com.ua
Authorization: Bearer p24live_...

Приклад успішної відповіді (200 OK)

{
  "id": "a3f9b2c1Kx",
  "url": "https://pay24.com.ua/pay/a3f9b2c1Kx",
  "merchant": 12345,
  "amount": 1400.00,
  "currency": "UAH",
  "purpose": "Рахунок №12345 за послуги",
  "status": "active",
  "expires_at": "2027-03-31 00:00:00",
  "created_at": "2025-04-01T14:22:00Z",
  "updated_at": "2025-04-01T14:25:31Z",
}

Приклад відповіді з помилкою (404 Not found)

{
  "error": "Invoice not found"
}

{id} — значення поля id з відповіді створення

Тіло запиту (JSON)

Приклад запиту

PATCH /v1/invoices/a3f9b2c1Kx HTTP/1.1
Host: api.pay24.com.ua
Authorization: Bearer p24live_...
Content-Type: application/json

{
  "status": "paid"
}

Успішна відповідь (200 OK)

Повертає рахунок з оновленим статусом — у тому ж форматі, що й GET /v1/invoices/{id}.

{
  "id": "a3f9b2c1Kx",
  "url": "https://pay24.com.ua/pay/a3f9b2c1Kx",
  "merchant": 12345,
  "amount": 1400.00,
  "currency": "UAH",
  "purpose": "Рахунок №12345 за послуги",
  "status": "paid",
  "expires_at": "2027-03-31 00:00:00",
  "created_at": "2025-04-01 14:22:00",
  "updated_at": "2025-04-02 09:10:45"
}

Відповідь з помилкою (422 Validation failed)

{
  "error": "Validation failed",
  "fields": {
    "status": "Required. Must be one of: active, paused, paid."
  }
}

Повертає рахунки вашого акаунта, від найновіших. Зручно для звірки банківської виписки з рахунками: передайте призначення і суму вхідного платежу — і отримаєте рахунок, який він оплачує.

Параметри запиту (усі необовʼязкові)

Приклад запиту

GET /v1/invoices?status=active&amount=1400&comment=Оплата%20згідно%20Рахунок%20№12345%20за%20послуги HTTP/1.1
Host: api.pay24.com.ua
Authorization: Bearer p24live_...

Успішна відповідь (200 OK)

{
  "data": [
    {
      "id": "a3f9b2c1Kx",
      "url": "https://pay24.com.ua/pay/a3f9b2c1Kx",
      "merchant": 12345,
      "amount": 1400.00,
      "currency": "UAH",
      "purpose": "Рахунок №12345 за послуги",
      "status": "active",
      "expires_at": "2027-03-31 00:00:00",
      "created_at": "2025-04-01 14:22:00",
      "updated_at": "2025-04-01 14:22:00"
    }
  ],
  "count": 1
}