API документація

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

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

Можливості чекаута:

Відображення вартості доставки замовлення відповідно до методу доставки НП (поштомат, відділення), кур'єр.
Вартість доставки відображається в деталях транзакції окремим полем та не є частиною кошику покупця.
У момент списання, чекаут додає вартість доставки в загальну ціну замовлення.
Вартість доставки передається в колбеці мерчанту.

Як АПІ відображає вартість доставки в залежності від обраного методу доставки?

Для того щоб отримати вартість доставки по методам доставки, mono checkout надсилає запит мерчанту для отримання вартості доставки.
У масиві параметрів mono checkout передає methods – масив обраних методів доставки. Актуальні: np_box, np_brnm, 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_box
Можливі методи доставки для відображення вартості доставки: Кур’єр, Відділення НП, Поштомат НП
phoneNumber
string
Номер телефона покупця у форматі +380 є опціональним параметром. Якщо покупець раніше додавав номер телефона до блока покупця, то передаємо номер телефона, навіть якщо користувач неавторизований
city
required
string
Місто доставки. Наприклад: Дніпро
address
string
Адреса доставки. Наприклад: Дніпро, Поля Олександра, 129р

Payload

200

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

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

Передається вартість доставки 0

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

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

200