Перейти к содержимому

Orders

Quote preparation and order lifecycle operations.

Операции

Prepare order (create quote)

Запрос

Creates a quote from the value in the qrCode field. The same field accepts three kinds of input (the type is auto-detected and returned as paymentType):

  • NSPK/SBP QR — a qr.nspk.ru URL, a bank deep link, or a multiqr.ru / platiqr.ru link → paymentType: nspk.
  • ST00012 string (ST00012|...) — utility / budget payments (ЖКХ). Amount is taken from the Sum field → paymentType: st00012.
  • gibdd:uin:{20–25 digits} — a traffic-police (ГИБДД) fine by UIN. Amount and requisites are resolved automatically → paymentType: gibdd_uin.

Quote TTL is short-lived (30 seconds in current implementation).

Безопасность
apiKeyAuth
Телоapplication/jsonобязательный
qrCodestring, <= 4000 charactersобязательный

What to pay. One of:

  • NSPK/SBP QR — qr.nspk.ru URL, bank deep link, or multiqr.ru / platiqr.ru link;
  • ST00012|... — utility / budget payment (ЖКХ), amount from Sum;
  • gibdd:uin:{20–25 digits} — ГИБДД fine by UIN.
externalOrderIdstring, <= 255 characters
curl -i -X POST \
  https://b2b-app.lumowallet.io/_mock/apis/orders/prepare \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "qrCode": "string",
    "externalOrderId": "string"
  }'

Ответы

Quote prepared

Телоapplication/json
idstring, (uuid)обязательный
amountRubnumberобязательный
amountUsdtnumberобязательный
ratenumberобязательный

RUB/USDT rate used for conversion

paymentTypestring(PaymentType)обязательный

Detected from the qrCode field:

  • nspk — QR СБП/NSPK (including multiqr / platiqr);
  • st00012 — utility / budget payment (ЖКХ);
  • gibdd_uin — ГИБДД fine by UIN.
Enum:"nspk""st00012""gibdd_uin"
expiresAtstring, (date-time)обязательный
isBalanceSufficientbooleanобязательный
merchantNamestring or null

Payee/brand name when available. For ST00012 it is ЖКХ, for ГИБДД fines it is ГИБДД.

Response
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "amountRub": 0,
  "amountUsdt": 0,
  "rate": 0,
  "paymentType": "nspk",
  "expiresAt": "2019-08-24T14:15:22Z",
  "isBalanceSufficient": true,
  "merchantName": "string"
}