Заказ виртуальных карт
Метод для заказа виртуальных карт.
URL
POST https://rest.lksup.ru/v1/order/virtualcards
Описание
Метод возвращает результат получения запроса на заказ карт.
Для выполнения запроса необходимо предоставить: - Авторизационные данные — JWT access токен - Параметры заказа карт - информация о заказе карт.
Примечание: Перед отправкой убедитесь, что тело запроса зашифровано корректно.
Структура запроса
В HTTP Header необходимо передать x-nonce, также в заголовок Authorization, помещается JWT токен. - Данные о запросе на заказ карт — идентификатор запроса на заказ карт. - X-Nonce: — значение состоит из случайных символов, используется в шифровании (передается в заголовке)
Пример запроса:
Формат запроса:
POST https://rest.lksup.ru/v1/order/plasticcards
Тело запроса:
{
"data":[
{"numberCards": 3000,
"typeCard":"MLZ",
"amount": 1500000}
]
}
Параметры запроса
| Параметр | Тип | Описание | Обязательный | Шифрование |
|---|---|---|---|---|
numberCards |
integer(10000) | Количество карт в заказе. Целое число от 1 до 5000. | Да | Да |
typeCard |
string | Тип карты. MLZ - Виртуальная карта СУП МИР. | Да | Да |
amount |
string | Сумма первого пополнения карт в копейках. Должна быть в диапазоне от 5000 до 1500000 копеек |
Да | Да |
Структура ответа
Пример успешного ответа - код 202
{
"orderId": "uuid"
}
Параметры успешного ответа
| Параметр | Тип | Описание |
|---|---|---|
orderId |
uuid | Идентификатор созданного заказа карт |
| --- |
Пример ответа с ошибкой
Ответы с ошибкой могут быть двух видов.
Пример ответа для кода состояния 422
{
"data":[
{"field": "string",
"message": "string"}
]
}
Пример ответа для кодов состояния 4хх, за исключением 422
{
"message": "string"
}
Возможные ошибки
| Статус | Описание |
|---|---|
| 401 | Не авторизован. Некорректный токен |
| 402 | Недостаточно средств на балансе |
| 422 | Передано некорректное значение |