Уведомления об оплате заказа
Обновлено 20 декабря 2023
Сервис, обеспечивающий отправку исходящих уведомлений в ходе процесса оплаты QR.
| Описание сервиса | Процесс | URL | Инициатор | Потребитель | Синхронный |
|---|---|---|---|---|---|
| Исходящий сервис уведомления об оплате /возврате заказа | Оплата: QR-код ПокупателяQR-код ПродавцаQR-код СБП Возврат: QR-код СБП | /notify:\<URL-Адрес проксирования вызова> ________________________________ * Партнер должен реализовать на своей стороне метод /notify со схемой https, на который будут приходить уведомления, и передать endpoint в СБЕР для проксирования вызова | Сбербанк | Клиент | Да |
Параметры запроса:
| Наименование атрибута | Mapping | Формат | Кратность | Паттерн | Описание | |
| rqUid | body | string(32) | [1] | [0-9a-fA-F]{32}\$ | Уникальный идентификатор запроса | |
| rqTm | body | string(20) | [1] | \^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z\$ | Дата/время формирования запросаexample: "2021-03-31T10:53:01Z" | |
| memberId | body | string(8) | [1] | \^[A-Za-z0-9_\-]{1,8}\$ | Идентификатор клиента | |
| idQR | body | string(36) | [1] | \^[A-Za-z0-9_\-]{1,36}\$ | Идентификатор устройства, на котором сформирован заказ. Правила заполнения: 1. Для операции "QR-код Продавца": IdQR (Уникальный идентификатор устройства в системе "Плати QR"); 2. Для операции "QR-код СБП": tid (Уникальный идентификатор) | |
| tid | body | string(8) | [1] | \^[A-Za-z0-9_\-]{1,8}\$ | Уникальный идентификатор терминала | |
| orderId | body | string(36) | [1] | \^[A-Za-z0-9_\-]{1;36}\$ | ID заказа (в АС Сбербанка) example: "bb072868e59e4f06a5ecbc44baa0e63c" | |
| partnerOrderNumber | body | string(36) | [1] | \^.+\$ | Номер заказа в CRM Клиента | |
| orderState | body | string(20) | [1] | Статус заказаenum: ["PAID", "CREATED", "REVERSED", "REFUNDED", "REVOKED", "DECLINED", "EXPIRED", "AUTHORIZED", "CONFIRMED", "ON_PAYMENT"] | ||
| operationId | body | string(50) | [1] | \^[A-Za-z0-9_\-]{1,50}\$ | Идентификатор операции в АС Сбербанка example: "767fa5f8d7aa4f0fad504bea782518f8" | |
| operationDateTime | body | string(20) | [1] | \^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z\$ | Дата/Время совершения операцииexample: "2021-03-31T10:53:01Z" | |
| rrn | body | string(12) | [0..1] | \^[A-Za-z0-9_\-]*\$ | RRN операции | |
| operationType | body | string(32) | [1] | Тип операции.enum: ["PAY", "REVERSE", "REFUND", "SBP_PAY_ACKNOWL", "SBP_ACK_ONUS", "SBP_STATUS_OUT", "SBP_CREDIT_IN_RQ", "SBP_REFUND_IN_RQ"] | ||
| operationSum | body | integer(15) | [0..1] | minimum: 0 maximum: 999999999999999 | Сумма операции в минимальных единицах Валюты | |
| operationCurrency | body | string(3) | [0..1] | \^[0-9]{3} | Валюта операции, цифровой код по ISO 4217. example: "643" | |
| authCode | body | string(8) | [0..1] | \^[A-Za-z0-9_\-]*\$ | Код авторизации | |
| responseCode | body | string(6) | [1] | \^[A-Za-z0-9_\-]*\$ | Код успешности авторизации. По операциям Сбер - 2 символа, по операциям Банков Партнеров 6 символов. | |
| responseDesc | body | string(256) | [0..1] | \^.*\$ | Описание кода ответа | |
| clientName | body | string(256) | [0..1] | \^.*\$ | Маскированное Имя Отчество Ф. плательщика | |
| sbpOperationParams | body | object | [0..1] | Блок с перечнем параметров операции СБП. Передается только для операции оплаты через СБП | ||
| sbpOperationId | body | string(50) | [1] | \^[A-Za-z0-9_\-]*\$ | Идентификатор операции в СБП example: "B105600390167601000004681598593B" | |
| sbpPayerId | body | string(36) | [1] | \^[A-Za-z0-9_\-+()*]\$ | Маскированный идентификатор плательщика |
Пример запроса OrderNotifyQrRq
{
"rqUid": "",
"rqTm": "2005-08-15T15:52:01Z",
"memberId": "00000003",
"idQR": "4000101124",
"tid": "20163714",
"orderId": "bb072868e59e4f06a5ecbc44baa0e63c",
"partnerOrderNumber": "190331500624",
"orderState": "PAID",
"operationId": "767fa5f8d7aa4f0fad504bea782518f8",
"operationDateTime": "2020-03-19T19:00:39Z",
"operationType": "PAY",
"responseCode": "00",
"rrn": "004207370593",
"operationSum": 800,
"operationCurrency": "643",
"authCode": "370694",
"responseDesc": "ResponseDesc",
"clientName": "Иван Иванович И."
}
Параметры ответа:
| Наименование атрибута | Mapping | Формат | Кратность | Паттерн | Описание |
| rqUID | body | string(32) | [1] | \^[0-9a-fA-F]{32}\$ | Уникальный идентификатор запроса |
| rqTm | body | string(20) | [1] | \^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z\$ | Дата/время формирования запросаexample: "2021-03-31T10:53:01Z" |
| partnerErrorCode | body | string(2) | [0..1] | \^[A-Za-z0-9_\-]*\$ | Код выполнения запроса Партнера |
| errorDescription | body | string(1024) | [0..1] | \^.*\$ | Описание ошибки выполнения запроса |
Пример ответа OrderNotifyQrRs
{
"rqUID": "bc13cA5CE261D2661d99f1fD1Bb049Ac",
"rqTm": "2022-03-15T15:52:01Z"
}