022-оплата-сбербанк-технические-особенности.md

/ документация / http⬅️, cms, email, тестирование, решение ошибок, демо, 54-ФЗ

Платежный метод "Сбербанк-Онлайн". От А до Я

Вне зависимости от того, самописный у вас сайт или он сделан на основе CMS (SaaS или других подобных решений), платежи методом "Сбербан-онлайн" одинаково формируются, обрабатываются и проходят до момента успешной оплаты (или ошибки). На этой странице показаны все основные нюансы, которые стоит знать.

Требования к интеграции

• Зарегистрируйтесь в ЮKassa (доступно только для юридических лиц и ИП);
• Получите от нас идентификаторы shopId и scid;
• Метод "Сбербанк-онлайн" должен быть вам подключен.

Шаг 1. Передача параметров

С вашего сайта (или приложения) отправляются стандартные параметры + 1-2 дополнительных (специальных для метода "Сбербанк-онлайн"). Все это настроено вашим программистом или "зашито" в платежном модуле CMS (на основе которой сделан ваш сайт). Ниже три варианта прохождения платежа, что может отправляться и в чем разница.

Варианты

Плательщик выбрал метод оплаты Сбербанк-онлайн на вашем сайте

• стандартные параметры +
  • <input required name="paymentType" value="SB" />
  • <input name="cps_phone" value="79001112233" />
    
    ^{value="SB" -- платежный метод Сбербанк-Онлайн;
    79001112233 -- российский мобильный телефонный номер плательщика в сбербанк-онлайн, обязательный параметр;
    вы можете не передавать параметр name="cps_phone", тогда плательщик должен будет заполнить сам на нашей платежной странице; обратите внимание, если вы его передали, плательщик может изменить значение номера телефона на шаге 2; какой номер в конечном итоге ушел в Сбербанк-онлайн мы вам не сообщаем, таковы правила.}

Плательщик не выбирает платежный метод на вашем сайте и нажимает кнопку заплатить

• стандартные параметры +
  • <input required name="paymentType" value="" />
  • <input name="cps_phone" value="79001112233" />
    
    ^{value="" -- платежный метод передается пустым, в результате метод оплаты плательщик выбирает на платежной странице яндекс.кассы, а не на вашем сайте;
    79001112233 -- российский мобильный телефонный номер плательщика в сбербанк-онлайн, обязательный параметр;
    вы можете не передавать параметр name="cps_phone", тогда плательщик должен будет заполнить сам на нашей платежной странице; обратите внимание, если вы его передали, плательщик может изменить значение номера телефона на шаге 2; какой номер в конечном итоге ушел в Сбербанк-онлайн мы вам не сообщаем, таковы правила.}

900

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

• MWS метод createInvoice +
  • invoiceType="sberbank"
  • smsPhoneNumber="79001112233"
    
    ^{"sberbank" -- платежный метод Сбербанк-Онлайн;
    79001112233 -- российский мобильный телефонный номер плательщика в сбербанк-онлайн, обязательный параметр;
    в отличии от двух предыдущих вариантов оплаты, передавать телефонный номер надо обязательно.}

Шаг 2

Шаг	Описание
	Эту страницу вы увидите после шага-1, если вашему магазину доступен Сбербанк-онлайн в режиме смс и в режиме оплаты через личный кабинет Сбербанка.

Шаг 2.1

Шаг	Описание
	Шаг 2.1 2. Если магазину запрещена оплата сбербанк-онлайн через смс и доступен только метод оплаты через личный кабинет сбербанка, после шага-1 плательщик увидит такую страницу

Шаг 3

Шаг	Описание
	2.1 А затем будет автоматические редирект на страницу личного кабинета Сбербанк-онлайн

Ошибки

Пример	Причины
	Не получилось. Техническая ошибка. Вариант 1 * платежный метод вам не подключен (с момента начала регистрации метода для вашего магазина может пройти 1-2 недели, прежде, чем метод вам будет подключен; время требуется на все этапы регистрации); если метод работал, но вы получаете эту ошибку, возможно, вам отключили этот метод, уточните у вашего менеджера;
	Не получилось. Техническая ошибка. Вариант 2 * в одном из параметров вы передаете неправильное или недопустимой значение; если не можете определить что, напишите нашим специалистам, они помогут.
	Что-то пошло не так Пример ошибки сбербанк-онлайн, в случае, когда плательщик открыл страницу из шага-2 и не выполнил оплату после в течении часа
	Не получилось. В Сбербанке Онлайн нет такого аккаунта. Заплатите другим способом. Если на шаге-2 в поле для телефона был указан телефон, к номеру которого не привязан аккаунт в сбербанк-онлайн, то плательщик получит такое соообщение: В Сбербанке Онлайн нет такого аккаунта. Заплатите другим способом.

checkOrder

Если Ваш URL для обработки checkOrder уведомлений не ответил нашей системе коррректно или был не доступен (надо понимать, что уведомление checkOrder наша система доставляет только один раз), при этом на стороне Сбербанка этот платеж будет считаться успешным, плательщик в личном кабинете Сбербанка будет видеть чек успешной оплаты. Но, т.к. ваша система не ответила корректно на наш запрос checkOrder, заказ считается ошибочным. Далее мы инициируем отмену платежа в Сбербанке (процедура занимает в пределах трех рабочих дней).