Створення заявки

Створює нову заявку на ПЧ для клієнта Monobank.

Важливо:

  • Клієнт повинен бути активним користувачем Monobank
  • Сума заявки не повинна перевищувати доступний ліміт клієнта
  • У клієнта не повинно бути інших незавершених заявок на ПЧ
  • Опційно вказуйте result_callback для отримання callback зі статусом

Ідемпотентність: При повторному запиті з однаковим store_order_id (ідентифікатор на стороні магазину):

  • Нова заявка НЕ створюється
  • Повертається ID існуючої заявки в системі Це захищає від випадкового дублювання заявок

Процес:

  1. Заявка створюється зі статусом IN_PROCESS
  2. Клієнт отримує push-повідомлення в додатку Monobank
  3. Після підтвердження клієнтом дочірній статус змінюється на WAITING_FOR_STORE_CONFIRM
  4. Магазин отримує callback або може перевірити статус через /api/order/state
AUTHORIZATIONS:
  • signature (in header)

    apiKey

    Підпис запиту

  • store-id (in header)

    apiKey

    Ідентифікатор магазину

REQUEST BODY SCHEMA: application/json
  • store_order_id

    required

    string >= 1 characters <= 64 characters

    Унікальний ідентифікатор замовлення в системі магазину

  • client_phone

    required

    string

    Номер телефону клієнта у міжнародному форматі

  • total_sum

    required

    number >= 1

    Загальна сума замовлення у гривнях

  • invoice

    required

    object (CreateOrderInvoice)

    Інформація про рахунок-фактуру

    invoice {
  • available_programs

    required

    array of object

    Доступні програми ПЧ

    available_programs [
  • products

    required

    array of object

    Товари для покупки частинами

    products [
  • result_callback

    string

    URL для отримання результату обробки заявки

  • additional_params

    object (CreateAdditionalParams)

    Додаткові параметри замовлення

    additional_params {
  • financial_company_merchant_info

    object (FinancialCompanyMerchantInfo)

    Інформація про продавця для фінансової компанії

    financial_company_merchant_info {
post

/api/order/create

Request samples
Payload

201 Заявка прийнята в обробку

400 Помилка у запиті

401 Підпис не передано або не валідний

403 Створення заявок заборонено

500 Внутрішня помилка сервісу

Response samples
201
400
401
403
500