Покупка с кошелька
Нужен ключ с правом buyer:orders:write. Деньги списываются с кошелька аккаунта сразу, по цене витрины. При любом ответе с ошибкой ничего не создаётся и не списывается.
Запрос
Передайте Idempotency-Key — повтор с тем же ключом вернёт тот же заказ. max_price_minor — сколько вы готовы заплатить за весь заказ. external_ref — ваш номер заказа, он уникален в пределах аккаунта.
POST /buyer-api/orders x-buyer-api-key: bk_live_… Idempotency-Key: order-1042 Content-Type: application/json { "variant_id": "variant_…", "quantity": 1, "max_price_minor": 120000, "external_ref": "1042" }
Ответы
| Ответ | Что это значит |
|---|---|
201 | Куплено. В ответе order |
200 | Повтор с тем же ключом — тот же заказ, второго списания нет |
402 insufficient_balance | Не хватает денег, сколько — в missing_minor |
409 price_changed | Заказ стоит дороже max_price_minor, новая сумма — в total_minor |
409 in_flight | Первый запрос с этим ключом ещё выполняется — повторите позже |
409 idempotency_conflict | Этот ключ уже использован с другим телом |
409 duplicate_external_ref | Заказ с таким external_ref уже есть |
400 | Нет ключа повтора, нет max_price_minor или запрос некорректен |
Оборвалась сеть после отправки? Повторите запрос с тем же Idempotency-Key. Новый ключ — это новая покупка.
Статусы заказа
| status | Что это значит |
|---|---|
pending | Оплачено, код готовится |
fulfilled | Коды готовы — читайте их в GET /buyer-api/orders/{id} |
refunded | Деньги вернулись на кошелёк. Причина в reason: out_of_stock, seller_failed, canceled |
failed | Выдача не удалась — напишите в поддержку с номером заказа |
Коды
curl https://api.libermall.com/buyer-api/orders/order_… \ -H "x-buyer-api-key: $LIBERMALL_BUYER_KEY" { "order": { "status": "fulfilled", "currency": "rub", "items": [{ "title": "PlayStation Store", "variant_title": "50 PLN", "codes": ["XXXX-XXXX-XXXX"], "instructions": "…" }] } }
Чтение кодов фиксируется как их передача — так же, как если бы покупатель нажал «Показать» на сайте. Не пишите коды в логи на своей стороне. Ответ 503 codes_unavailable — повторите чуть позже.
Найти заказ по своему номеру
curl "https://api.libermall.com/buyer-api/orders?external_ref=1042" \ -H "x-buyer-api-key: $LIBERMALL_BUYER_KEY"
Ответ 409 in_flight значит, что покупка по этому номеру ещё не завершилась.
Если товар закончился
Деньги вернутся на кошелёк сами, а на ваш адрес придёт событие order.refunded с причиной. Ничего делать не нужно — только сообщите своему покупателю.