Быстрые откупы

Назначение

Быстрые откупы — это отдельный merchant API flow для создания pay-out сделки по QR-ссылке. Мерчант передаёт QR, а система валидирует ссылку, достаёт сумму из QR и создаёт обычную pay-out сделку с методом QR.

Сумма не передаётся мерчантом в body и не выбирается вручную. Для этой фичи валюта всегда RUB.

Поддерживаемые QR

Разрешены только домены:

multiqr.ru
platiqr.ru
qr.nspk.ru
nspk.ru

Для multiqr.ru и platiqr.ru сумма берётся из query-параметра amount.

Для qr.nspk.ru и nspk.ru сумма определяется по QR-коду через проверку NSPK; query-параметры суммы не используются как источник истины.

API Flow

Проверить QR через POST /payment/instant-pay-out/validate.
Если ответ содержит { "valid": true, "amount": ... }, создать быстрый откуп через POST /payment/instant-pay-out.
Получить стандартный response pay-out сделки.
Отслеживать статус через обычные webhook-уведомления и методы получения сделок.

Endpoint валидации возвращает:

valid
amount

Для невалидного QR endpoint возвращает amount: null. Он по-прежнему не раскрывает домен, причину отклонения или технические данные проверки.

Ограничения

amount не нужно передавать в create request.
Если currency передан, поддерживается только RUB.
Matching flags и OST/cascade режимы не используются для быстрых откупов.
В админке быстрые откупы находятся в существующем разделе Откупы через фильтр метода QR.

Ошибки Создания

Создание будет отклонено, если QR-ссылка невалидна, домен не поддерживается, сумма отсутствует, NSPK вернул неуспешный статус, proxy pool недоступен, передана не RUB валюта или merchantTransactionId уже существует.