Подарочные сертификаты Lamoda — предоплаченные сертификаты фиксированного номинала, которыми конечные покупатели оплачивают заказы на Lamoda. Через API продавец выпускает сертификаты нужных номиналов, отслеживает их и переводит в статус «оплачено».
Функционал предназначен для партнёров, у которых подарочные сертификаты подключены по договору с Lamoda. Выпуск и оплата сертификатов возможны в пределах баланса партнёра — суммы, которую можно перевести в сертификаты. Баланс пополняется переводом средств на счёт, указанный в договоре.
Заключение договоров и пополнение баланса не являются функционалом API
Как это работает
- У партнёра есть баланс — доступная сумма номиналов (пополняется в рамках заключенного договора).
- Партнёр выпускает сертификаты нужных номиналов — они создаются неоплаченными.
- Партнёр переводит их в статус «оплачено» (
mark-paid) — номиналы при этом списываются с баланса. - Только оплаченные сертификаты покупатели могут использовать для оплаты заказов на Lamoda.
У сертификата два независимых статуса:
- статус оплаты (
paymentStatus):NEW→PAID; либоFAILED(ошибка оплаты) /RETURNED(платёж возвращён); - статус обработки (
processingStatus):NEW→ACTIVE(активирован) →SPENT(потрачен); либоEXPIRED(истёк срок) /BLOCKED(заблокирован).
Порядок работы
Детали полей и значений смотрите в справочнике по ссылке на метод.
1. Выпуск сертификатов
POST /v2/gift-certificates— выпустить сертификаты. В теле запроса —sellerId,country(RU/BY/KZ),currencyиcertificates[](каждый элемент —{ amount, quantity }: номинал и количество). За один запрос — до 100 позиций.
Суммы номинала указываются в минорных единицах валюты (копейки для RUB): amount: 100000 = 1000,00 ₽.
Выпущенные сертификаты создаются неоплаченными (paymentStatus: NEW). Чтобы ими можно было расплатиться, переведите их в статус «оплачено» (шаг 3).
2. Получение списка сертификатов и проверка баланса
GET /v2/gift-certificates— список выпущенных сертификатов: код активации, номинал, страна, срок действия, статусы оплаты и обработки. Поддерживает фильтры (по датам, коду, статусам) и пагинацию.GET /v2/gift-certificates/balance— баланс: сумма номиналов, доступная для перевода сертификатов в статус «оплачено».
3. Перевод сертификатов в статус «оплачено»
POST /v2/gift-certificates/mark-paid— перевести сертификаты в статус «оплачено». В теле метода вы передаетеsellerIdиcertificateIds(идентификаторы выпущенных сертификатов). Перевод в статус «оплачено» возможен при достаточном балансе; номиналы при этом списываются с баланса. Только оплаченные сертификаты доступны покупателям для оплаты заказов.
См. также
Помогла эта информация?
Спасибо за отзыв