К содержанию
Libermall для разработчиков
Buyer API › Покупка с кошелька

Покупка с кошелька

Нужен ключ с правом 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 с причиной. Ничего делать не нужно — только сообщите своему покупателю.