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

Ордера

Котировки и операции с ордерами на всём их жизненном цикле.

Операции

Создать котировку

Запрос

Создаёт котировку по значению из поля qrCode. Поле принимает три вида данных (тип определяется автоматически и возвращается в paymentType):

  • QR НСПК/СБП — ссылка qr.nspk.ru, диплинк банка или ссылка multiqr.ru / platiqr.ru → paymentType: nspk.
  • Строка ST00012 (ST00012|...) — ЖКХ и бюджетные платежи. Сумма берётся из поля Sum → paymentType: st00012.
  • gibdd:uin:{20–25 цифр} — штраф ГИБДД по УИН. Сумма и реквизиты подтягиваются автоматически. Штраф оплачивается либо обычным платежом СБП (paymentType: nspk), либо, если так нельзя, по реквизитам (paymentType: gibdd_uin, merchantName: ГИБДД). Обрабатывайте оба варианта.

Котировка живёт 30 секунд. После подтверждения id котировки становится id ордера. Нужно право orders.create.

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

Что оплатить. Одно из:

  • QR НСПК/СБП — ссылка qr.nspk.ru, диплинк банка или ссылка multiqr.ru / platiqr.ru;
  • ST00012|... — ЖКХ или бюджетный платёж, сумма из Sum;
  • gibdd:uin:{20–25 цифр} — штраф ГИБДД по УИН.
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"
  }'

Ответы

Котировка создана

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

Курс RUB/USDT, по которому идёт конвертация

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

Определяется по полю qrCode:

  • nspk — QR СБП/НСПК (в том числе multiqr / platiqr);
  • st00012 — ЖКХ или бюджетный платёж;
  • gibdd_uin — штраф ГИБДД по УИН.
Enum:"nspk""st00012""gibdd_uin"
expiresAtstring, (date-time)обязательный
isBalanceSufficientbooleanобязательный
merchantNamestring or null

Название получателя или бренда, если известно. Для ST00012 — получатель из поля Name, для штрафов ГИБДД — ГИБДД.

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