Оплаты
Last updated
Last updated
IMSHOP Retail Protocol (IRP) является объектом интеллектуальной собственности ООО «АЙ ЭМ СОЛЮШНЗ» (IMSHOP) и защищён как объект авторского права. Свидетельство о депонировании произведения № 023-014461 от 16 января 2023 г. подтверждает исключительные права ООО «АЙ ЭМ СОЛЮШНЗ» на данные технологии.
IMSHOP Retail Protocol создан по заказу ООО «АЙ ЭМ СОЛЮШНЗ». Использование IMSHOP Retail Protocol допустимо только при взаимодействии с ООО "АЙ ЭМ СОЛЮШНЗ" и наличии действующего лицензионного договора. Более подробно можно ознакомиться здесь.
POST
https://api-imshop.store.ru/v1/payments
externalUserId
— идентификатор покупателя на стороне клиента, если тот авторизован в мобильном приложении, null
по умолчанию
country
— ISO код страны, RU
hasPreorderItems
— в случае если в запросе товары с предзаказом
city
— стандартизированное имя города из системы ФИАС (или UUID ФИАС, в зависимости от настроек)
promocode
— прикрепленный промокод в виде строки, null
по умолчанию
deliveryId
— идентификатор выбранного способа доставки, см. «Доставки»
pickupLocationId
— выбранный пункт получения заказа, см. «Доставки» (null
, если доставка или не подразумевает выбора ПВЗ)
bonusesSpent
— кол-во бонусов которые пользователь планирует потратить
legalEntityMode
– передается и имеет значение true
, если при оформлении заказа выбрано юридическое лицо
items
— список товаров в корзине
id
— идентификатор товара в IMSHOP.IO
configurationId
— идентификатор товарного предложения в системе клиента (идентификатор из фида)
privateId
— идентификатор товара в системе клиента (group_id
из фида)
quantity
— количество
Ритейлер имеет возможность предложить альтернативные условия: отключение рассрочки из-за примененной скидки, оплата только онлайн из-за лимитированности подарков и т.д.
Доп. поле promoGroup
передаётся в запрос списка оплат. Описание формата приведено в разделе Список "Маркетинговые акции"
Для маркетплейсов.
В полях запроса для каждого товара могут быть переданы идентификаторы магазина/ООО (в разработке).
warehouseId
— (опционально) идентификатор склада/магазина/аутлета/ООО из фида наличия для маркетплейсов
payments
— список доступных способов оплаты
description
— описание, строка
deliveryDiscount
— процент скидки на выбранную доставку (если для оплаты доставка бесплатна, то 100), число 0-100
cash
- оплата наличными
card_on_delivery
- картой курьеру или при получении
card
- картой в приложении
iOS
- Apple Pay
android
- Google Pay
autoVerification
— включить автопроверку платежа для данного способа оплаты, boolean
widget
- виджет в котором детально описывается правило рассрочки для пользователя
description
- описание рассрочки
paymentGraphic
- детализация графика платежей
periodDescription
- описание конкретного периода оплаты, как правило пишется дата
periodPrice
- цена конкретного периода оплаты
progress
- процентное разделение платежа
Если в ответе не будут отданы ВСЕ обязательные поля - в приложении не отобразятся доставки
id
— идентификатор, строка (обязательное поле)
title
— название, строка (обязательное поле)
type
— тип из перечисленных (обязательное поле):