Описание
Есть 2 вида платежных шлюзов Сбербанка:
- "тестовый" - https://3dsec.sberbank.ru/
- "боевой" - https://securepaymentgateway.ru/ или https://securepayments.sberbank.ru/
Выставление реальных счетов для оплаты производится через "боевой" шлюз, который можно использовать, если у вас зарегистрирован интернет-эквайринг Сбербанк и есть API-токен.
Для регистрации переходим на сайт и нажимаем кнопку “Оставить заявку”. Откроется окно, где требуется ввести свои данные и отправить заявку на подключение. Далее связываемся с менеджером. На вопрос "Тип Эквайринга" - необходимо ответить "Интернет-Эквайринг". Также можно сделать запрос по эл.адресу: support@ecom.sberbank.ru или в офисе банка.
Согласовываем отправку на свою почту письма со всеми необходимыми данными: логин, пароль, токен и др.
Формат ссылки
https://securepayments.sberbank.ru/payment/docsite/payform-1.html?token=ВАШ_ТОКЕН&def={"amount":"СУММА_СЧЕТА"}&def={"email":"ПОЧТА_ДЛЯ_ОТПРАВКИ_ЧЕКА"}&def={"description":"ОПИСАНИЕ_СЧЕТА"}&ask={"name":"ИМЯ_ДОП_ПОЛЯ","placeholder":"","label":"ИМЯ_ДОП_ПОЛЯ"}&lang=ru
В обработке ссылка генерируется динамически по данным документа или через поля ввода интерфейса формы.
ВАШ_ТОКЕН - это индивидуальный API-токен, который необходимо получить при регистрации интернет-эквайринга.
Токен определяет реквизиты получателя платежа, и его наличие обязательно для успешной оплаты.
Ссылка шлюза и токен вводятся в обработке пользователем один раз и далее хранятся в настройках.
Описание платежа, почта плательщика, сумма извлекаются из реквизитов выбранного документа и контрагента, но также можно ввести эту информацию вручную на форме. Почту плательщика можно оставить пустым - в этом случае плательщик введёт электронный адрес на странице оплаты.
ИМЯ_ДОП_ПОЛЯ - позволяет запросить у плательщика информацию: ФИО, Телефон, Адрес доставки и др. Текст дополнительного поля является поясняющим для ввода информации на странице оплаты. Дополнительное поле не является обязательным и может быть отключено флагом на форме.
При установленном флаге "Автосокращение ссылки" будет выполнен http запрос на веб-сервис clck.ru для получения сокращённой ссылки. Эту же функцию можно выполнить вручную нажатием клавиши "Сократить" на форме обработки для сформированной ссылки.
Далее нужно нажать клавишу "Сформировать". Ссылка формируется, после чего выполняется подготовка ссылки путём замены url кодами таких символов как: пробелы, скобки, спецсимволы и символы кириллицы. Это необходимо для корректной работы ссылки в браузере, а также при отправке почтовыми клиентами.
Демонстрация
Пример токена: "f5eb7yao31iyf1p2of12ues531"
Пример ссылки (без внедрённых url-кодов):
https://securepayments.sberbank.ru/payment/docsite/payform-1.html?token=f5eb7yao31iyf1p2of12ues531&def={"amount":"1220.00"}&def={"description":"Оплата по документу Реализация товаров и услуг ТД00-000003"}&def={"email":"client@testmail.ru"}&ask={"name":"Телефон","placeholder":"","label":"Телефон"}&lang=ru
Результат (скриншот справа):
Совместимость
Обработки универсальные для обеих платформ 1С 8 или 1С 7.7, и совместимы с любыми конфигурациями (УТ,УНФ,УПП,КА,ERP,БУХ,БП,ТиС,Комплексная и др.), в том числе нетиповыми.
Код обработок открыт для самостоятельного улучшения и доработок.
Тестировалось на конфигурациях 1С 8: Бухгалтерия предприятия, редакция 3.0 (3.0.44.140); Комплексная автоматизация 2 (2.4.7.151); Управление торговлей, редакция 11 (11.4.7.150); Управление торговлей (базовая), редакция 10.3 (10.3.18.3); Розница, редакция 2.2 (2.2.9.19), Управление производственным предприятием, редакция 1.3 (1.3.143.1).
Тестировалось на конфигурациях 1С 7.7: Бухгалтерский учет, редакция 4.5 (7.70.537); Комплексная конфигурация, редакция 4.5 (7.70.492); Торговля и Склад, редакция 9.2 (7.70.974).
Версия 1.2 ред.2 [27.03.23]
- почта плательщика для формирования ссылки счета теперь необязательна - если почта не задана, плательщик сможет ввести почтовый адрес на странице оплаты;
- добавлен флаг и поле с текстом для запроса дополнительной информации (ФИО, Телефон, Адрес) - плательщик сможет ввести дополнительную информацию на странице оплаты;
- добавлено поле-список для выбора языка (ru, en), который изменяет язык страницы оплаты;
- доработан алгоритм извлечения адреса электронной почты контрагента для конфигураций (УПП), использующих регистр сведений КонтактнаяИнформация;
- дополнительные подсказки и проверки заполнения параметров;
- (ред.2) в список ссылок платёжного шлюза добавлен пункт: https://securepaymentgateway.ru/payment/docsite/payform-1.html?token=
- доработан интерфейс формы обработки;
Версия 1.1 [06.09.20]
- добавлена функция автосокращения ссылки с использованием веб-сервиса CLCK.RU;
- доработан алгоритм подготовки ссылки - замена спецсимволов и символов кириллицы url кодами;
