• Платёжный шлюз (ПШ, Шлюз) — комплекс решений для осуществления процесса интернет-эквайринга с использованием различных платёжных средств.
• Партнер — система или лицо, которое взаимодействует с ПШ.
• Плательщик — физическое или юридическое лицо, совершающее платёж по своей карте за услуги мерчанта в ПШ.
• Заказ — элементарная сущность ПШ, описывающее заказ в некотором интернет-магазине или его аналоге.
• Одностадийный платёж — операция по оплате товаров/услуг, не требующая дополнительного подтверждения (Завершения), то есть блокирование и списание средств происходит в один этап. Этот вид платежей предпочтительней, если товар или услуга предоставляется сразу после оплаты.
• Двухстадийный платёж — операция по оплате товаров/услуг, требующая дополнительного подтверждения (Завершения), то есть оплата производится в два этапа. На первом этапе происходит проверка наличия и блокирование средств плательщика (предавторизация); далее, на втором этапе, компания либо подтверждает необходимость списания средств, либо отменяет блокировку средств. Сумма списания может отличаться от суммы блокировки в меньшую сторону.
• Универсальная Платежная Ссылка - Платежная ссылка предназначенная для оплаты Цифровым Рублем (ЦР). Использование ЦР доступно при соблюдении следующих условий:
  • Открыт счет в ЦР через Сбербанк / получен доступ к счету через Сбербанк;
  • Подписан договор по СБП;
  • Подписано доп/соглашение к договору СБП об использовании УПК (Универсального платежного кода) для приема оплат цифровым рублем;
  • Выполнено подключение к ecom АПИ Сбербанка.
• Холдирование (Блокировка средств) - Состояние суммы средств, предназначенных для возмещения по проведенной операции, с момента успешной авторизации до момента завершения расчетов между банками-участниками. На данном этапе средства еще находятся на счете Плательщика, но уже недоступны для использования на карте.
• Возврат средств (Refund) — частичный или полный возврат денежных средств Плательщика в случае его отказа от получения товара/услуг или его возврата. Возврат — это офлайн-операция, которая производится после списания денежных средств с Плательщика. Сроки возмещения, как правило, зависят от банка-эмитента и могут достигать 30 дней.
• Отмена операции оплаты (Reversal) — операция снятия (отмены) удержания денежных средств Плательщика. Отмена — это онлайн-операция, то есть эмитент карты сразу получает запрос на разблокировку суммы. Отмена может быть произведена до начала взаиморасчётов банков-участников, поэтому доступна ограниченное время.
• Связка — соответствие между Плательщиком и платёжными реквизитами карты (номер карты или токена и срок его действия).
• 3-D Secure (3DS) — протокол дополнительной аутентификации Плательщика, основанный на концепции трёх доменов: эквайрера, эмитента и совместимости.
• Access Control Server (ACS) — элемент инфраструктуры 3-D Secure, обеспечивающий аутентификацию Плательщика на стороне банка-эмитента.
• MPI, 3DS Server — элемент инфраструктуры 3-D Secure на стороне банка-эквайрера или Партнера.
• Фискализация (54-ФЗ) - процедура формирования фискального чека по успешно оплаченному Заказу. В данное понятие входит как формирование чека по успешной оплате, так и формирование чека возврата, закрывающего чека и т.д.
• ФФД - Формат Фискальных Документов. Стандарт Федеральной Налоговой Службы, согласно которому формируются все фискальные чеки.
• Электронный сертификат (ЭС) — запись в Государственной информационной системе электронных сертификатов (ГИС ЭС). Держатель ЭС получает доступ к этой записи с помощью национального платежного инструмента, в качестве которого выступает карта ПС «Мир».
• ТРУ — Товар/работа/услуга
• НСПК — Национальная система платёжных карт
• ФЭС — Фронт-офис Электронных Сертификатов НСПК – решение для торгово-сервисного предприятия для реализации возможности приобретения отдельных видов товаров, работ, услуг с использованием средств ЭС

• Координаты подключения. Информация о координатах подключения к тестовой среде также доступна в индивидуальном разделе для каждого сервиса (в правой части страницы).

Внимание! Для корректного взаимодействия со шлюзом необходимо установить сертификат НУЦ Минцифры.

Внимание! На тестовом контуре предусмотрены технические окна: в будние дни зарезервированы временные интервалы 02:00 - 06:00, 09:00 - 10:00 и 18:00 - 20:00 (время Московское) в течение которых могут осуществляться работы по внедрению функционала на тестовый стенд. Стабильность работоспособности контура в это время не гарантируется.

Тестовая среда: https://ecomtest.sberbank.ru/...(полная ссылка для конкретного сервиса указана в примерах)

Боевая среда: https://epay.sberbank.ru/...(полная ссылка для конкретного сервиса указана в примерах)

• Платёжный шлюз представляет HTTP REST сервисы методом POST, с передачей в заголовках "Content-Type: application/json" и набором символов в кодировке UTF-8. Сообщения передаются в формате JSON (RFC 7159);
• Наименования объектов в сервисах передаются с учетом регистра;
• При взаимодействии используется протокол TLS версии 1.2 и 1.3;
• После регистрации Партнера, предоставляются логин и пароль, который необходимо использовать при подключении к ПШ;
• Для взаимодействия с сервисами ПШ требуется установить сертификат НУЦ Минцифры.

Внимание! Не допускается присвоение значения "null" параметрам! Если параметр принимает значение "null", его необходимо полностью исключить из тела запроса.

В зависимости от целей и потребностей Партнер может использовать сценарии, предоставленные в текущем разделе, для проведения платежей следующих типов:

• Одностадийный платеж - операция, не требующая отдельного запроса на проведение расчетов: эта процедура осуществляется автоматически в конце текущего дня (~23:59 МСК)
• Двухстадийный платеж - операция с предавторизацией. Проходит в два этапа: на первом этапе осуществляется предавторизация (PreAuth) в результате чего на карте Плательщика происходит Холдирование средств. На втором этапе Партнер инициирует проведение расчетов на сумму не более суммы Холдирования.

При использовании сценария с Предавторизацией рекомендуется инициировать проведение расчетов в течение 7 календарных дней.

Ввод реквизитов на стороне Партнера без 3DS на стороне Шлюза

Ввод реквизитов на стороне Партнера c 3DS на стороне Шлюза

Ввод реквизитов на стороне Партнера с упрощённым 3DS на стороне Шлюза

Ввод реквизитов на стороне Шлюза

Оплата с использованием связок

Общий алгоритм проведения оплаты по связке.

Сценарий разбит на два этапа:

1. Создание связки.

Ниже приведено краткое описание алгоритма создания связки.

1.1. После получения согласия со стороны Плательщика на дальнейшее использование данных карты для проведения оплат, Партнер регистрирует заказ с помощью register.do (с обязательной передачей параметра clientId.

Внимание! В случае отсутствия указанного параметра (clientId) в запросе - связка не будет создана. В запросе так же может быть передан features=VERIFY. В этом случае сумма заказа должна составлять 0 рублей 0 копеек, средства с Плательщика не списываются. При этом сохраняется проведение всех необходимых проверок. Данный способ регистрации заказа является наиболее корректным для формирования связок.

1.2. Плательщик оплачивает заказ со всеми аттрибутами: вводом карточных данных и 3DS или оплатой операции через SberPay.

1.3. При успешной оплате заказа будет создана связка, идентификатор которой можно будет получить с помощью запросов getOrderStatusExtended.do и/или getBindings.do.

1.4. Опциональный шаг. При необходимости возврата средств по заказу (при авторизации на сумму, отличную от 0 рублей 0 копеек) может быть направлен запрос reverse.do. Отмена требуется для предотвращения фактического списания средств в случае использования технической операции для привязки карты.

Создание связки завершено.

2. Оплата с использованием связки

Ниже приведено краткое описание алгоритма проведения оплаты с использованием имеющейся связки.

Доступно несколько путей оплаты, инициатором которой может выступать как Плательщик, так и Партнер.

1. Инициатором выступает Партнер.

Способ 1.

1.1.1. Партнер отправляет запрос recurrentPayment.do.

1.1.2. Платежный шлюз обогащает запрос данными карты, соответствующими полученному от Партнера bindingId.

1.1.3. Проводится авторизация с использованием данных карт, заполненных в п. 1.1.2.

1.1.4. Партнеру направляется результат авторизации.

Способ 2.

1.2.1. Партнер регистрирует заказ с помощью register.do / registerPreAuth.do с обязательной передачей параметра clientId.

1.2.2. Инициируется оплата заказа с помощью paymentOrderBinding.do с передачей параметра bindingId.

Внимание! Параметр bindingId должен соответствовать переданному при регистрации заказа clientId. В случае попытки оплаты связкой, созданной для другого clientId вернется ошибка "Заказ не может быть оплачен данной связкой"

1.2.3. Платежный шлюз проверяет соответствие clientId и bindingId. При корректном результате проверки Платежный шлюз обогащает запрос данными карты, соответствующими переданному значению bindingId.

1.2.4. Проводится авторизация с использованием данных карт, заполненных в п. 1.2.3.

1.2.5. Партнеру направляется результат авторизации.

2. Инициатором выступает Плательщик.

2.1. Плательщик выбирает оплату сохраненной картой.

2.2. Партнер регистрирует заказ с помощью register.do / registerPreAuth.do с обязательной передачей параметра clientId.

2.3. Инициируется оплата заказа с помощью paymentOrderBinding.do с передачей параметра bindingId.

Внимание! Параметр bindingId должен соответствовать переданному при регистрации заказа clientId. В случае попытки оплаты связкой, созданной для другого clientId вернется ошибка "Заказ не может быть оплачен данной связкой"

2.4. Платежный шлюз проверяет соответствие clientId и bindingId. При корректном результате проверки Платежный шлюз обогащает запрос данными карты, соответствующими переданному значению bindingId.

2.5. Проводится авторизация с использованием данных карт, заполненных в п. 1.2.3.

2.6. Партнеру направляется результат авторизации.

2.7. Партнер оповещает Плательщика о результате авторизации.

Внимание! При несоответствии clientId и bindingId Партнеру возвращается ошибка "Заказ не может быть оплачен данной связкой".

В сфере электронной коммерции конверсия является одним из важнейших показателей. При корректной интеграции и интуитивном клиентском пути одним из основных способов улучшения показателей является передача дополнительных параметров.

Дополнительные параметры позволяют получить более полную информацию о клиентах и их платежных операциях, позволяя весомо снизить риски мошенничества и исключить избыточные блокировки операций со стороны Банка, НСПК и иных эмитентов. Передача дополнительных параметров доступна при регистрации заказа и в сервисах оплаты в блоках jsonParams или additionalParameters в соответствии с описанием сервиса в документации.

Передача корзины и идентификатора аккаунта плательщика партнера являются наиболее весомыми факторами, позволяющими повысить конверсию. Передача корзины заказа может использоваться без функционала фискализации.

Дополнительные параметры могут пересекаться с параметрами 3DS и в большинстве случаев влияют на результат аутентификации плательщика, повышая вероятность работы по frictionless flow.

Ошибки данного блока возвращаются на этапе валидации запроса к Шлюзу

Ошибки данного блока возвращаются на этапе обработки вызываемого сервиса

Ошибки данного блока возвращаются при успешной обработке операции Процессинговым центром. Каждый заказ имеет 3 попытки оплаты до истечения срока действия заказа (по умолчанию — 20 минут, значение может быть указано при регистрации заказа).

При взаимодействии с Платежным шлюзом Партнеру доступен функционал оплаты с помощью SberPay в мобильном приложении "Сбербанк-Онлайн". Имплементация функционала для достижения наилучших возможных показателей конверсии предусматривает соответствие платежного опыта Партнера с требованиями Банка, описание функционала и примеры имплементации доступны в ознакомительных материалах.

SberPay поддерживает платежный функционал в APP-канале. Применяются 2 схемы реализации платежного функционала:

• SberPay SDK InApp
• SberPay App2App

SberPay SDK InApp

SDK – Это набор средств для разработки, благодаря которым можно легко интегрировать SberPay в мобильное приложение партнера и улучшить клиентский опыт.

Преимущества SDK InApp: • Отсутствует потребность в доработках внедренного метода. Доработки и поддержку поверхности SDK InApp производит Банк; • Повышает конверсию в оплату. На поверхности SDK InApp доступны все карты Сбера, отображается баланс и дополнительные финансовые сервисы Сбера; • Продвинутый клиентский опыт. Минимальный клиентский путь. Поддержка длительной авторизации по куки. Не уводим клиентов с поверхности Партнера. Качественный UX/UI платежной поверхности; • Санкции не влияют на стабильность работы SDK InApp.

Материалы для разработчиков доступны по ссылке

SberPay App2App

Устаревший функционал SberPay позволяющий интегрировать SberPay в приложение партнера. Оплата подтверждается и производится в приложении Сбера посредством диплинка встраиваемого в кнопку оплаты со SberPay

SberPay поддерживает свой функционал оплаты на десктопных и мобильных WEB-сайтах.

SberPay WEB SDK

WEB SDK позволяет интегрировать с веб-сайтом партнера нативную платежную поверхность SberPay. Это техническое решение является передовым клиентским опытов в SberPay и обладает преимуществами:

• Простое внедрение. Банк предоставляет готовую библиотеку, партнеру достаточно встроить ее на свой WEB-сайт;
• Не уводим клиента с WEB-сайта. Для клиента оплата производится на сайте без переходов куда-либо. Удобная платежная штора позволяет видеть все карты клиента, их баланс и поддерживает финансовые сервисы Сбера;
• Нет затрат на поддержку. Клиентский опыт на платежной поверхности обновляется и поддерживается силами Банка;
• Достаточно войти один раз. Если клиент авторизовался на платежной поверхности – мы его запомним. Последующие оплаты производятся бесшовно.

Материалы для разработчиков доступны по ссылке

SberPay Web2App (нативная интеграция)

Альтернативный платежный опыт нативной оплаты на WEB поверхностях без использования платежной страницы. Функционал оплаты реализован по двум сценариям:

• Партнер выводит на поверхность сайта QR-код. Для оплаты клиент должен его отсканировать. Подтверждение и завершение оплаты производится в приложении Сбербанка;
• Партнер выводит кнопку «Оплатить по номеру телефона». Для оплаты клиент вводит свой номер, привязанный к приложению Сбербанка. После чего ему направляется ПУШ или смс. По ПУШ или по ссылке в СМС – откроется приложение Сбербанка, где клиент подтверждает и завершает оплату. ВАЖНО! В данном платежном функционале требуется особо тщательное соблюдение UX/UI рекомендаций Банка.

Платежная страница

Платежная страница СберБанка по умолчанию устанавливается при подключении эквайринга СБЕРа. У партнера есть возможность подключить еще и оплату через SberPay на поверхности платежной страницы. Это простой и удобный способ совершать онлайн-покупки. Клиенту достаточно нажать на кнопку оплаты со SberPay и отсканировать QR-код (или выбрать оплату по номеру телефона). Завершение оплаты производится в приложении СберБанка где клиенту доступна возможность выбрать любую карту из имеющихся. Вам не потребуется никаких доработок, если у вас подключен эквайринг СберБанка. Оставить заявку на подключение SberPay вы можете на сайте

Обратите внимание! Работа с функционалом оплаты с помощью SberPay доступна в рамках сервисов, описанных в документации, но может быть интегрирована Партнером отдельно от других способов оплаты. При работе с функционалом SberPay использование блока "sberbankOnlineAttributes" в теле запроса в jsonParams является обязательным при регистрации заказа в сервисах register/registerPreAuth.

При интеграции сценария mweb2app на устройствах apple необходимо реализовывать процедуру перебора диплинков. Это связано с различными версиями приложений, установленных на устройствах пользователей. Подробная инструкция по реализации процедуры доступна в документе.

Дополнительно ознакомиться с процедурой тестирования SberPay можно в документации.

Описание требований к клиентскому опыту при реализации функционала SberPay в приложенном документе.

Описание интеграции функционала SberPay в приложенном документе.

Руководство по логотипам для SberbankOnline в приложенном документе.

Обработка операций и ответы Шлюза соответствуют описанию, размещенному в разделах Описание кодов ответа Шлюза и Описание кодов ошибок Шлюза.

Пример оплаты с использованием SDK SberPay можно увидеть по ссылке.

Инструкции по имплементации SberPay SDK для сайтов и мобильных приложений находятся по ссылке.

С примером отрисовки кнопки SberPay можно ознакомиться по ссылке.

Допустимые варианты отрисовки логотипа SberPay находятся в приложенном документе

В соответствии с Федеральным законом РФ №54-ФЗ c 01.07.2017 при осуществлении онлайн продаж, Продавец (в данной документации - Клиент), с помощью онлайн-кассы, обязан формировать кассовый чек и направлять его в ФНС и покупателю. В целях исполнения данного требования ПАО Сбербанк разработан механизм интеграции с онлайн-кассами, позволяющий упростить для Партнера данную процедуру. На текущий момент Платежным шлюзом поддерживаются только кассы "АТОЛ Онлайн", “Цифровая касса ЭВОТОР”, "Бизнес.ру" с версиями ФФД 1.05 и 1.2, а так же "OFD.RU" с версиями ФФД 1.1 и 1.2.

• Отправка данных онлайн-кассе для формирования чеков в форматах ФФД 1.05 и 1.2;
• Формирование чеков прихода, возврата прихода (в том числе - частичного);
• Возможность переотправки неуспешного чека с изменением корзины;
• Переотправка чека в случае возникновения ошибки кассы или при таймауте отправки;
• Создание чека отдельно от финансовой операции (закрывающий чек);
• Возможность разделения чека на несколько, в случае превышения максимального размера;
• Получение статуса чека отдельным API запросом.

Для успешной регистрации кассового чека необходимо выполнение следующих условий:

• Для создания чека необходимо передать корзину с обязательным присутствием параметров ffdVersion и receiptType в любом из сервисов register, registerPreAuth, deposit, reverse, refund;
• В каждом чеке будут присутствовать параметры, которые были переданы в составе соответствующего сервиса;
• Функционал фискализации заказов подключен и успешно настроен для мерчанта: учетные данные для подключения онлайн-кассы корректны и внесены в настройки.

С 01.04.2025 перед продажей маркированных товаров необходимо осуществлять онлайн проверку кода маркировки в Честном Знаке. Существует 2 способа осуществления проверки:

1. На стороне вашего кассового сервиса необходимо включить проверку КМ и указать заранее полученный токен Честного Знака. Проверка будет осуществляться автоматически кассовым сервисом, и данные будут передаваться в Честный Знак. В этом случае нельзя передавать в составе корзины sectoralItemProps (тег 1260) и все вложенные объекты. Обратите внимание, данные способ поддерживают только кассовые сервисы Бизнес.Ру и Ferma от OFD.RU.
2. Самостоятельная интеграция с Честным Знаком для получения данных о статусе кода маркировки, и включение этих данных в объект sectoralItemProps (тег 1260) при формировании "закрывающего" чека.

Состав тега 1260:

Для подключения кассы Эвотор необходимо:

1. Зарегистрироваться в сервисе Цифровая касса для получения облачной кассы или установить приложение Цифровая касса из магазина Эвотор вашей онлайн-кассы.
2. Самостоятельно, в соответствии с инструкцией или с помощью сотрудников Эвотор зарегистрируйте кассу в Федеральной Налоговой Службе (ФНС) и у Оператора Фискальных Данных (ОФД).
3. В личном кабинете Цифровой кассы (если используете облачную кассу) или в личном кабинете Эвотор (если используете онлайн-кассу) получите учетные данные кассы – Код группы касс.
4. Настроить интеграцию можно через личный кабинет СберБизнес или направив запрос в службу технической поддержки интернет-эквайринга Сбербанка. В запросе следует указать Код группы касс, используемую версию ФФД и merchantID, предоставленный Банком.

Для подключения кассы АТОЛ необходимо:

1. Зарегистрироваться в сервисе "АТОЛ Онлайн";
2. Самостоятельно, в соответствии с инструкцией или с помощью сотрудников АТОЛ Онлайн зарегистрируйте кассу в Федеральной Налоговой Службе (ФНС) и у Оператора Фискальных Данных (ОФД);
3. В личном кабинете АТОЛ Онлайн получите учетные данные кассы (логин, пароль, код группы ККТ);
4. Настроить интеграцию можно через личный кабинет СберБизнес или направив запрос в службу технической поддержки интернет-эквайринга Сбербанка. В запросе следует указать учетные данные кассы и используемую версию ФФД.

Для подключения кассы OFD.RU необходимо:

1. Зарегистрироваться в личном кабинете Партнера OFD.RU;
2. Зарегистрируйте кассу в Федеральной Налоговой Службе (ФНС);
3. В личном кабинете Партнер OFD.RU получите учетные данные кассы (логин и пароль);
4. Настроить интеграцию можно через личный кабинет СберБизнес или направив запрос в службу технической поддержки интернет-эквайринга Сбербанка. В запросе следует указать учетные данные кассы и используемую версию ФФД.

Для подключения кассы Бизнес.Ру необходимо:

1. Зарегистрироваться в личном кабинете Бизнес.Ру;
2. Зарегистрируйте кассу в Федеральной Налоговой Службе (ФНС);
3. Обратиться в поддержку Бизнес.Ру с запросом подключения интеграции Сбербанка api-sberbank;
4. В личном кабинете Бизнес.Ру получите учетные данные кассы (логин и пароль);
5. Настроить интеграцию можно через личный кабинет СберБизнес или направив запрос в службу технической поддержки интернет-эквайринга Сбербанка. В запросе следует указать учетные данные кассы и используемую версию ФФД.

Функционал находится в разработке

СберСпасибо - это бонусная программа лояльности от ПАО «Сбербанк» для своих клиентов.

На специальный бонусный счет Плательщика, начисляется процент от суммы покупки, которую Плательщик совершает по карте.

Для того, чтобы на бонусный счёт Плательщика начислялись бонусы при оплате картой, магазину, подключённому к Платёжному шлюзу, не требуется выполнять дополнительных вызовов на своей стороне.

Накопленными бонусами (1 бонус равен 1 рублю) можно оплачивать товары в магазинах-партнёрах программы. Предоставление возможности оплачивать товары/услуги бонусами возможно несколькими способами.

Оплата с использованием бонусов на платёжной странице ПШ

Оплата с использованием бонусов в SberPay

Оплата с использованием бонусов по связке

• Заказ должен быть оформлен в рублях РФ
• Доступна только полная отмена заказа (частичная отмена заказа недоступна)
• Вместо стандартных сервисов завершения двухстадийного сценария deposit и возврата средств Плательщика refund необходимо использовать аналогичные сервисы autoCompletion и autoRefund с указанием общей суммы операции в рублях и бонусах
• В случае завершения двухстадийного сценария или возврата на частичную сумму Платежный шлюз произведёт перерасчёт пропорции бонусов и рублей
• При работе с товарной корзиной осуществляются дополнительные проверки на содержание корзины:

  • Для каждой товарной позиции произведение стоимости единицы товара itemPrice на количество товарных позиций quantity.value должно строго равняться итоговой стоимости товарной позиции itemAmount

  • Сумма стоимостей всех товарных позиций itemAmount должна равняться итоговой сумме чека total и сумме операции в запросе amount/compositeAmount

  • Для связанных операций в рамках одного заказа (завершение двухстадийного сценария, отмена, возврат) необходимо:

    • Передавать корзину в случае, если она была передана при регистрации заказа
    • Обеспечить неизменность уникальных идентификаторов товарных позиций внутри Корзины positionId и itemCode
    • Передавать стоимости товаров itemPrice и itemAmount до вычета бонусов

  • Уникальный идентификатор товарной позиции внутри Корзины (positionId) должен быть больше или равен 1

  • Доступен возврат только товарных позиций, участвовавших в оплате при одностадийном сценарии (переданных в запросе register) или в завершении платежа при двухстадийном сценарии (переданных в запросе autoCompletion)

  • За распределение скидки по товарной корзине при оплате бонусами отвечает процессинг лояльности СберСпасибо

  • В связи с особенностью распределения бонусов СберСпасибо на стороне процессинга лояльности по переданным товарным позициям Шлюз использует следующую методику округления при осуществлении возвратов:

    • определяется стоимость позиции со скидкой путем вычитания из изначальной стоимости позиции размера скидки на позицию;
    • определяется цена единицы товара путем разделения стоимости позиции со скидкой на количество товара с применением математического округления;
    • при возврате стоимости последней единицы товара в позиции её цена рассчитывается путем вычитания из стоимости позиции со скидкой цены всех предыдущих товаров.

    Пример:

    • В корзине 3 товара с ценой 33.00. Применяется скидка бонусами СберСпасибо 29.99.
    • Стоимость позиции с учетом скидки: 33.00 - 29.99 = 3.01.
    • Цена единицы товара с учетом скидки: 3.01 / 3 = 1.00
    • Цена последней возвращаемой единицы товара: 3.01 - 1.00 - 1.00 = 1.01.

    Данная методика применима при реализации собственного решения по фискализации.

  • В случае использования функционала фискализации на стороне Шлюза (функционал находится в разработке):

    • Платежный шлюз вычитает применённую скидку бонусами из стоимости товарной позиции. Вычитание скидки за счет бонусов не распространяется на сервис создания нового чека doReceipt
    • В случае, если после применения скидки бонусами невозможно корректно рассчитать цену за единицу товара, производится разделение одной товарной позиции на две товарные позиции с разными ценами за единицу товара с сохранением общей стоимости товарных позиций
• Данные о состоянии бонусов по программам лояльности в заказе доступны в ответе на сервис получения информации о заказе getOrderStatusExtended

Функционал находится в разработке

Электронный сертификат – это новый платежный инструмент, который предоставляет возможность самостоятельно приобретать отдельные виды товаров, работ и услуг за счет средств бюджетов при наличии оснований на получение мер государственной поддержки в натуральной форме. Электронный сертификат выпускается к карте ПС «Мир», а оплата работает аналогично операциям с использованием банковских карт и позволяет мгновенно оплатить отдельные виды товаров при наличии оснований на предоставление мер социальной поддержки.

Сертификат содержит сведения о том, какие товары, работы или услуги, в каком количестве и на какую предельную сумму можно приобрести с его использованием. Сами денежные средства на карту ПС «Мир» не перечисляются, а резервируются в бюджете до совершения покупки. При этом использовать собственные средства необходимо только в случае, если количество и (или) стоимость приобретаемых товаров, работ или услуг превышает количество и (или) предельную стоимость в электронном сертификате.

Для того, чтобы подключить возможность принимать оплаты с помощью электронных сертификатов, Мерчанту необходимо:

1. Для осуществления расчетов по операциям с использованием ЭС требуется заключить дополнительное соглашение к договору ИЭ.

2. Для возможности взаимодействия с Фронт-офисом Электронных Сертификатов НСПК ТСП Мерчанту необходимо поддерживать кодировку товаров, согласованную с перечнем товаров/работ/услуг - truCode.

3. Зарегистрироваться в Государственной информационной системе электронных сертификатов ГИС ЭС

4. В системах внутреннего учета продавца требуется обеспечить кодировку ТРУ согласно перечню, утвержденному в соответствии с постановлением Правительства Российской Федерации от 23.04.2021 № 631 «О порядке формирования и утверждения Перечней отдельных видов товаров, работ, услуг, приобретаемых с использованием электронного сертификата за счет средств бюджета бюджетной системы Российской Федерации». Актуальный перечень публикуется в Единой системе нормативной справочной информации.

5. Пройти регистрацию продавца и магазинов в Автоматизированной системе сбора анкет (АССА) для получения ключа доступа (API KEY). На электронный адрес сотрудника продавца, указанного при заполнении формы на сайте Государственной информационной системы электронных сертификатов (ГИС ЭС) на шаге 3 в качестве технического специалиста , АО «НСПК» направляет ссылку для входа в АССА и создания пароля для доступа в личный кабинет продавца в АССА. При первом входе АССА предложит установить пароль для входа.

6. Имея API KEY, Мерчант должен получить идентификатор кассы (cashboxId) и ключа кассы (MAC KEY) в ФЭС НСПК.

7. Мерчант должен передать API KEY, cashboxId, MAC KEY Банку-эквайеру и провести тестовую операцию.

8. Перейти в промышленную среду.

Руководство для торгово-сервисных предприятий по организации приема электронных сертификатов при оплате отдельных видов товаров, работ, услуг размещено на официальном сайте АО «НСПК» в разделе Электронные сертификаты – Оферта для ТСП

Оплата с использованием ЭС на платёжной странице ПШ

• Заказ должен быть оформлен в рублях РФ
• По операциям, оплаченным с помощью ЭС, недоступна отмена операции. Поддерживаются частичные и полные возвраты товаров, приобретенных c использованием средств ЭС. При возврате товара, приобретенного с использованием средств ЭС, средства возвращаются на счет ЭС.
• За счет средств ЭС частично или полностью оплачиваются только товары, по которым переданы коды ТРУ (truCode), товары из товарной корзины без кодов ТРУ не участвуют в процессе оплаты ЭС.
• При работе с ЭС передача товарной корзины является обязательной. На стороне ПШ осуществляются дополнительные проверки на содержание товарной корзины:
  • Для каждой товарной позиции произведение стоимости единицы товара itemPrice на количество товарных позиций quantity.value должно строго равняться итоговой стоимости товарной позиции itemAmount
  • Сумма стоимостей всех товарных позиций itemAmount должна равняться итоговой сумме чека total и сумме операции amount в запросе
  • При формировании операции возврата необходимо обеспечить неизменность параметров товарных позиций корзины: positionId, itemCode, itemPrice, truCode
  • Доступен возврат только товарных позиций, участвовавших в оплате (переданных в запросе register)
• Данные о состоянии средств ЭС в заказе доступны в ответе на сервис получения информации о заказе getOrderStatusExtended
• В случае проведения фискализации на стороне Клиента, после получения реквизитов фискального чека покупки или возврата от онлайн кассы, необходимо передать данные параметры фискального чека в сервисе externalReceipt для передачи их в ФЭС. Если фискализация осуществляется на стороне ПШ, то дополнительных вызовов для работы с ЭС не требуется.

Ознакомиться с инструкциями по работе в личном кабинете Сбербанк Бизнес Онлайн вы сможете на сайте Сбербанка. Ниже приведены наиболее востребованные ссылка на разделы по работе с заказами интернет-эквайринга.

• Создание ссылки на оплату
• Завершение двухстадийных заказов
• Отмена по заказам (одно- и двухстадийных)
• Сброс пароля от шлюза и генерация API-key
• Формирование отчетности
• Оформление возврата (в том числе частичного) по заказу
• Поиск заказ

Сервис доступен при соблюдении следующих условий:

1. Открыт счет в ЦР через Сбербанк / получен доступ к счету через Сбербанк

2. Подписан договор по СБП

3. Подписано доп/соглашение к договору СБП об использовании УПК (Универсального платежного кода) для приема оплат цифровым рублем.

4. Выполнено подключение к ecom АПИ Сбербанка

1. Партнер создает заказ методом register.do, указывая в блоке jsonParams "qrType" значение "DYNAMIC_QR_SBP", "sbp.scenario" значение "C2B", поле "description" заполняется опционально.

2. При обработке запроса на создание заказа Сбер получает в НСПК универсальную платежную ссылку с двумя способами оплаты – СБП и ЦР (ссылка УПК), и передает ее партнеру в ответ на register.do.

3. Партнер использует payload в своем app/mWEB, используя виджет НСПК https://widget.cbrpay.ru/v1, или формирует и отображает клиенту QR-код.

4. Клиент-физическое лицо выбирает свой банк в списке банков-эмитентов, сформированном виджетом, или сканирует QR-код, далее переходит в приложение своего банка и подтверждает оплату цифровым рублем.

5. После проведения оплаты через контур Платформы цифрового рубля Банка России, НСПК, Сбер получает подтверждение о получении платежа, и присваивает заказу статусы, соответствующие результату оплаты.

6. Сбер направляет партнеру информацию о статусе заказа в ответ на запрос getOrderStatusExtended.do, либо в callback. Если заказ был оплачен Цифровыми рублями, то в ответе значение параметра в объекте cardAuthInfo "paymentWay" = "NSPK_DIGITAL_RUB", в объекте "transactionAttributes" параметр "extTransactionId" будет содержать идентификатор операции на Платформе Цифрового рубля.

Методы API для создания заказа, отмены заказа, получения статуса заказа, осуществления возврата средств по заказу.

Методы API для проведения оплаты заказа

Методы API для создания, получения информации, активации, деактивации, проведения платежей по связкам. Внимание! Для некоторых категорий мерчантов (MCC) рекуррентные платежи по картам МИР недоступны.

Методы API для работы с платежами MirPay