Нотификация по платежам через QR

Обновлено 27 августа 2025

Отправка нотификаций по факту совершения платежа по QR.

Запрос

Header Parameters

rqUid

rqUid

required

Возможные значения: <= 32 characters, Value must match regular expression ^[0-9a-fA-F]{32}$

X-Target-Host

string

required

Возможные значения: <= 255 characters, Value must match regular expression ^.*$

X-PartnerAuthorization

string

Возможные значения: <= 512 characters, Value must match regular expression ^.*$

Body

required

rqUid

rqUid (string)

required

Возможные значения: <= 32 characters, Value must match regular expression ^[0-9a-fA-F]{32}$

Уникальный идентификатор запроса

rqTm

string

required

Возможные значения: <= 20 characters, Value must match regular expression ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$

ДатаВремя формирования запроса

memberId

string

required

Возможные значения: <= 8 characters, Value must match regular expression ^[a-zA-Z0-9_\-\\]{1,8}$

Идентификатор клиента

idQR

string

required

Возможные значения: <= 36 characters, Value must match regular expression ^[a-zA-Z0-9_\-\\]{1,36}$

IdQR устройства или tid Уникальный идентификатор терминала для СБП , на котором сформирован заказ

tid

string

required

Возможные значения: <= 8 characters, Value must match regular expression ^[a-zA-Z0-9_\-\\]{1,8}$

Уникальный идентификатор терминала

orderId

string

required

Возможные значения: <= 36 characters, Value must match regular expression ^[a-zA-Z0-9_\-\\]{1,36}$

ID заказа в АС ППРБ.Карты

partnerOrderNumber

string

required

Возможные значения: <= 36 characters, Value must match regular expression ^.+$

Номер заказа в CRM Клиента

orderState

string

required

Возможные значения: <= 20 characters, [PAID, CREATED, REVERSED, REFUNDED, REVOKED, DECLINED, EXPIRED, ON_PAYMENT]

Статус заказа: PAID - В привязке к заказу есть успешная операция покупки на сумму заказа/ успешная операция покупки и неуспешная(-ые) операции отмены, CREATED - Создан или в привязке к заказу есть неуспешные авторизации, REVERSED - В привязке к заказу есть успешные операции Полной отмены/Частичной отмены, REFUNDED - В привязке к заказу есть успешные операции Полного возврата/Частичного возврата, REVOKED - Отменен до проведения фин.операции, DECLINED - Заказ отклонен - не прошла оплата по SberPay, EXPIRED - Истек срок жизни заказа, ON_PAYMENT - Для QR СБП - ожидает подтверждения платежа от СБП

operationId

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[a-zA-Z0-9_\-\\]*$

Идентификатор операции в АС Банка(ППРБ Ecom)

operationDateTime

string

required

Возможные значения: <= 20 characters, Value must match regular expression ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$

ДатаВремя совершения операции

rrn

string

Возможные значения: <= 12 characters, Value must match regular expression ^[a-zA-Z0-9_\-\\]*$

RRN операции

operationType

string

required

Возможные значения: <= 32 characters, [PAY, REVERSE, REFUND, SBP_PAY_ACKNOWL, SBP_ACK_ONUS, SBP_STATUS_OUT, SBP_CREDIT_IN_RQ, SBP_REFUND_IN_RQ]

Тип операции

operationSum

integer

Возможные значения: >= 0 и <= 999999999999999

Сумма операции в минимальных единицах Валюты

operationCurrency

string

Возможные значения: <= 3 characters, Value must match regular expression ^[0-9]{3}$

Валюта операции, цифровой код по ISO 4217

authCode

string

Возможные значения: <= 8 characters, Value must match regular expression ^[a-zA-Z0-9_\-\\]*$

Код авторизации

responseCode

string

required

Возможные значения: <= 6 characters, Value must match regular expression ^[a-zA-Z0-9_\-\\]*$

Код успешности авторизации. По операциям СБ - 2 символа, по операциям Банков Партнеров 6 символов.

responseDesc

string

Возможные значения: <= 256 characters, Value must match regular expression ^.*$

Описание кода ответа

clientName

string

Возможные значения: <= 256 characters, Value must match regular expression ^.*$

Маскированное Имя Отчество Ф. плательщика

sbpOperationParams

object

Блок с перечнем параметров операции СБП. Передается только для операции оплаты через СБП

sbpOperationId

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[a-zA-Z0-9_\-\\]*$

Идентификатор операции в СБП

sbpPayerId

string

required

Возможные значения: <= 36 characters, Value must match regular expression ^[A-Za-z0-9_\-+()\\*]*$

Маскированный идентификатор плательщика

Ответы

200 OK

Schema

rqUID

string

Возможные значения: <= 32 characters, Value must match regular expression ^[0-9a-fA-F]{32}$

Уникальный идентификатор ответа

rqTm

string

required

Возможные значения: <= 20 characters, Value must match regular expression ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$

ДатаВремя формирования ответа

partnerErrorCode

string

Возможные значения: <= 2 characters, Value must match regular expression ^[a-zA-Z0-9_\-\\]*$

Код выполнения запроса Партнера

errorDescription

string

Возможные значения: <= 1024 characters, Value must match regular expression ^.*$

Описание ошибки выполнения запроса

rqUid

string

Возможные значения: <= 32 characters, Value must match regular expression ^[0-9a-fA-F]{32}$

Уникальный идентификатор ответа

{
  "rqUID": "ac11cA1CEae1D1111dABf1fD1Bb0acAd",
  "rqTm": "2005-08-15T15:52:01Z",
  "partnerErrorCode": "00",
  "errorDescription": "ErrorDescription",
  "rqUid": "ac11cA1CEae1D1111dABf1fD1Bb0acAd"
}

Client Error 400 Bad Request (Запрос не корректен)'

Schema

httpCode

string

required

Значение должно соответствовать регулярному выражению ^[0-9]{1,3}$

Код ошибки

httpMessage

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[0-9a-zA-Z]*$

Описание ошибки

moreInformation

string

required

Возможные значения: <= 254 characters, Value must match regular expression ^[0-9a-zA-Zа-яА-Я]*$

Дополнительная информация

{
  "httpCode": "400",
  "httpMessage": "Error",
  "moreInformation": "Error"
}

Client Error 401 Unauthorized (Приложение не авторизовано, либо некорректное значение client-id)

Schema

httpCode

string

required

Значение должно соответствовать регулярному выражению ^[0-9]{1,3}$

Код ошибки

httpMessage

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[0-9a-zA-Z]*$

Описание ошибки

moreInformation

string

required

Возможные значения: <= 254 characters, Value must match regular expression ^[0-9a-zA-Zа-яА-Я]*$

Дополнительная информация

{
  "httpCode": "400",
  "httpMessage": "Error",
  "moreInformation": "Error"
}

Forbidden

Schema

httpCode

string

required

Значение должно соответствовать регулярному выражению ^[0-9]{1,3}$

Код ошибки

httpMessage

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[0-9a-zA-Z]*$

Описание ошибки

moreInformation

string

required

Возможные значения: <= 254 characters, Value must match regular expression ^[0-9a-zA-Zа-яА-Я]*$

Дополнительная информация

{
  "httpCode": "400",
  "httpMessage": "Error",
  "moreInformation": "Error"
}

Not Found

Schema

httpCode

string

required

Значение должно соответствовать регулярному выражению ^[0-9]{1,3}$

Код ошибки

httpMessage

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[0-9a-zA-Z]*$

Описание ошибки

moreInformation

string

required

Возможные значения: <= 254 characters, Value must match regular expression ^[0-9a-zA-Zа-яА-Я]*$

Дополнительная информация

{
  "httpCode": "400",
  "httpMessage": "Error",
  "moreInformation": "Error"
}

Method Not Allowed (Ошибка API gateway, не найдены операци и, поддерживающие запрошенную http-команду)

Schema

httpCode

string

required

Значение должно соответствовать регулярному выражению ^[0-9]{1,3}$

Код ошибки

httpMessage

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[0-9a-zA-Z]*$

Описание ошибки

moreInformation

string

required

Возможные значения: <= 254 characters, Value must match regular expression ^[0-9a-zA-Zа-яА-Я]*$

Дополнительная информация

{
  "httpCode": "400",
  "httpMessage": "Error",
  "moreInformation": "Error"
}

Too Many Requests (Превышен лимит отправляемых запросов)

Schema

httpCode

string

required

Значение должно соответствовать регулярному выражению ^[0-9]{1,3}$

Код ошибки

httpMessage

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[0-9a-zA-Z]*$

Описание ошибки

moreInformation

string

required

Возможные значения: <= 254 characters, Value must match regular expression ^[0-9a-zA-Zа-яА-Я]*$

Дополнительная информация

{
  "httpCode": "400",
  "httpMessage": "Error",
  "moreInformation": "Error"
}

Internal Server Error (Внутренняя ошибка сервера

Schema

httpCode

string

required

Значение должно соответствовать регулярному выражению ^[0-9]{1,3}$

Код ошибки

httpMessage

string

required

Возможные значения: <= 50 characters, Value must match regular expression ^[0-9a-zA-Z]*$

Описание ошибки

moreInformation

string

required

Возможные значения: <= 254 characters, Value must match regular expression ^[0-9a-zA-Zа-яА-Я]*$

Дополнительная информация

{
  "httpCode": "400",
  "httpMessage": "Error",
  "moreInformation": "Error"
}

Service Unavailable (Операция не доступна)

Gateway Timeout

Loading...