Ссылка на заказ и возврат плательщика
Ссылку на платежную страницу формирует сервис и возвращает в поле url ответа на успешное создание заказа (201 Created). Партнеру не нужно собирать ссылку самостоятельно — достаточно взять готовый url и передать его плательщику, при необходимости дополнив параметром адреса возврата.
Ссылка на заказ
Базовый формат ссылки:
https://sbi.sberbank.ru:9443/ic/ufs/orders/{externalId}
где {externalId} — UUID заказа, присвоенный партнером.
Ссылка действительна до истечения срока оплаты заказа (expirationTime): после истечения срока платежная страница не открывается — плательщик увидит страницу ошибки, а заказ перейдет в финальный статус EXPIRED (см. раздел 6, «Статусы заказа»).
Возврат плательщика на сайт партнера (backUrl)
Партнер может самостоятельно дополнить полученную ссылку параметром backUrl — адресом страницы, на которую Банк вернет плательщика после успешного завершения сценария оплаты:
https://sbi.sberbank.ru:9443/ic/ufs/orders/{externalId}?backUrl={backUrl}
Правила работы с backUrl:
- Значение
backUrlнеобходимо закодировать (URLEncode) перед подстановкой в ссылку. - Если
backUrlне указан, после подписания платежного поручения плательщик не возвращается на платформу партнера — Банк показывает ему страницу успешной оплаты сервиса «Сразу». - Если
backUrlотличается от адреса платформы, зарегистрированного партнером при созданииclient_id, то при возврате плательщик увидит страницу ошибки. Адрес возврата должен совпадать с зарегистрированным.
Способы передачи ссылки плательщику
- редирект или кнопка на сайте / в корзине партнера;
- отправка по email или в мессенджере;
- преобразование в QR-код для офлайн-точки продаж (менеджер показывает QR на экране или печатает на документе).
По открытии ссылки плательщик попадает на стартовую страницу заказа без авторизации — сразу видны сумма, наименование сервиса, дата и срок оплаты; состав заказа дост упен по раскрытию «Детали заказа» (подробнее — в разделе 3, «Клиентский путь»).