Відображення вартості доставки на екрані mono checkout

mono checkout може відображати вартість доставки для інформування клієнтів про додаткову вартість доставки, для обробки замовлень, враховуючи вартість доставки та передачі вартості доставки в деталях транзакції.

Можливості чекаута:
  • Відображення вартості доставки замовлення відповідно до методу доставки НП (поштомат, відділення, вантажне відділення), кур'єр.
  • Вартість доставки відображається в деталях транзакції окремим полем та не є частиною кошику покупця.
  • У момент списання, чекаут додає вартість доставки в загальну ціну замовлення.
  • Вартість доставки передається в колбеці мерчанту.
Як АПІ відображає вартість доставки в залежності від обраного методу доставки?
  • Для того, щоб отримати вартість доставки по методам доставки, mono checkout надсилає запит мерчанту для отримання вартості доставки
  • У масиві параметрів mono checkout передає methods – масив обраних методів доставки. Актуальні: np_box, np_brnm, np_cargo, courier
  • Мерчант віддає вартість доставки за кожним з переданих методів доставки
  • Після цього, на чекауті можна побачити вартість доставки
  • Після отримання вартості доставки, вартість замовлення збільшується згідно з вартістю доставки
  • Після оплати, вартість доставки відображена в інформації про кошик в веб кабінеті
  • Після оплати прийде колбек з вартістю доставки по обраному покупцем методом
Що потрібно зробити для підключення АПІ?
  • Мерчанту потрібно підготувати сервіс для прорахунку та передачі вартості замовлення
  • Підключення до сервісу виконується в налаштуваннях веб кабінету чекауту, для цього необхідно додати URL сервісу для отримання вартості замовлення
HEADER PARAMETERS:

  • Authorization

    string

    Basic <(client:passcode)>

post

/your-end-point

REQUEST BODY SCHEMA: application/json

  • orderRef

    required

    string

    ID замовлення. Формуєтсья на боці мерчанта

  • methods

    required

    array of object

    enum:
    couriernp_brnmnp_boxnp_cargo

    Можливі методи доставки для відображення вартості доставки: Кур’єр, Відділення НП, Поштомат НП

  • phoneNumber

    string

    Номер телефона покупця у форматі +380 є опціональним параметром. Якщо покупець раніше додавав номер телефона до блока покупця, то передаємо номер телефона, навіть якщо користувач неавторизований

  • city

    required

    string

    Місто доставки. Наприклад: Дніпро

  • address

    string

    Адреса доставки. Наприклад: Дніпро, Поля Олександра, 129р

Request samples
Payload

200

Response samples
200
Безкоштовна доставка (price = 0)

Коли значення price дорівнює нулю?

  • Передається вартість доставки 0
Узгодження вартості доставки (price = null)

Коли price має значення null, у колбек не передаємо вартість доставки

Комбінації відображення методу доставки та вартості доставки
Увімкнено в кабінетіНа чекауті бачимо
НП відділення
НП поштомати
НП вантажні відділення
НП відділення
НП поштомати
НП вантажні відділення
НП відділення
НП поштомати
НП відділення
НП поштомати
НП вантажні відділення
НП поштомати
НП вантажні відділення
НП поштомати
НП вантажні відділення
НП поштомати
НП поштомати
НП вантажні відділення
НП вантажні відділення
  1. Якщо веб-кабінеті увімкнено одразу:
    1. НП відділення
    2. НП поштомати
    3. НП вантажні відділення
    то до запиту передадуться всі три:
    – "np_brnm", "np_box", "np_cargo"
  2. Якщо увімкнено:
    1. НП відділення
    2. НП поштомати
    (але не увімкнено НП вантажні відділення)
    то до запиту передадуться всі три:
    – "np_brnm", "np_box", "np_cargo"(автоматично)
  3. Якщо увімкнено:
    1. НП поштомати
    2. НП вантажні відділення
    то до запиту передадуться всі три:
    – "np_box", "np_cargo"
  4. Якщо увімкнено:
    1. НП вантажні відділення
    то до запиту передадуться всі три:
    – "np_cargo"
  5. Якщо увімкнено:
    1. НП відділення
    то до запиту передадуться всі три:
    – "np_brnm", "np_cargo"
  6. Якщо увімкнено:
    1. НП поштомати
    то до запиту передадуться всі три:
    – "np_box"
Response samples
200