Імпорт ключа для підпису запитів кнопки monopay

Генерація та імпорт ключів

Для роботи з кнопкою monopay потрібно згенерувати пару ECDSA P-256 ключів та імпортувати публічний ключ в систему monobank.

Генерація ключів через OpenSSL
                
# Генеруємо приватний ключ ECDSA P-256
openssl ecparam -name prime256v1 -genkey -out private.pem

# Виводимо публічний ключ з приватного
openssl ec -in private.pem -pubout -out pubkey.pem
  • private.pem — приватний ключ, використовується для формування підпису на бекенді. Не передавайте цей ключ на фронтенд або сторонні сервіси!
  • pubkey.pem — публічний ключ, потрібно конвертувати в Base64
Підготовка публічного ключа для імпорту
                
# Конвертуємо публічний ключ в Base64 для імпорту
base64 -i pubkey.pem

Отриманий Base64 передається в keyValue

HEADER PARAMETERS:

  • X-Token

    required

    string

    Токен можна отримати через підтримку або тестовий токен з https://api.monobank.ua/

REQUEST BODY SCHEMA: application/json

  • keyValue

    required

    string

    Значення ключа (Base64)

  • keyName

    string

    Назва ключа (клієнтська назва)

  • expiresAt

    string <date-time>

    Дата та час, коли термін дії ключа закінчується

post

/api/merchant/monopay/pubkey-import

Request samples
Payload

200 Ключ успішно імпортовано

400 Один із вхідних параметрів невалідний

403 Токен невалідний

405 Http-метод невалідний

429 Занадто багато запитів

500 Під час виконання запиту виникла непередбачена помилка

Response samples
200
400
403
405
429
500
Про кнопкуВидалення ключа для підпису