Sorry, you need to enable JavaScript to visit this website.

You are here

Общая информация

Для подключения к системе магазин предоставляет:

HTML-страницу, с графикой и CSS и прочими подключаемыми объектами, которая показывает платежную форму. Требования к этой странице описаны в отдельном документе "Оформление платежной страницы".

В результате подключения магазин получает:

Логин – имя магазина в рамках платежного шлюза. Оно используется только для произведения операций посредством API.

Пароль – пароль магазина в рамках платежного шлюза. Используется только для произведения операций посредством API.

Алгоритм действий для подключения к платежному шлюзу

1. Получение логинов и паролей на тестовый сервер.

2. Верстка платежной страницы.

3. Загрузка архива с платежной страницы на тестовый сервер.

4. Тестирование работоспособности платежной страницы:

  • с использованием интерфейса REST \ интерфейса на web- сервисах
  • с использованием формы для регистрации заказа
  • с использованием личного кабинета и консоли

5. По готовности интеграции и страницы свяжитесь с службой сопровождения (support@ecom.sberbank.ru), чтобы вашу платежную страницу

проверили. Если проверка прошла успешно, сотрудники сопровождения перенесут Вашу платежную страницу на боевой сервер.

6. Получение логинов и паролей на боевой сервер.

7. Переключение вашего магазина на использование промышленной системы.

8. Произведение тестовой оплаты настоящей картой (рекомендуется провести оплату по 3DS-карте, а также выполнить SSL-платеж).

9. Выполнить отмену и возврат платежа через личный кабинет платежа.

10. Подписание акта о готовности интернет-магазина.

Взаимодействия реализуются как HTTP обращения методами GET или POST на определенные URL, для каждого типа - свой (см. раздел "Координаты подключения"). Параметры передаются как параметры GET или POST запросов, значения должны быть совместимы с URL (т.е. url encoded).

Результат обработки запроса возвращается в виде JSON объекта. Например:

{"errorCode":"12","errorMessage":"Empty
 amount"}

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

Название

Тип

Обязательность

Описание

userName

AN..30

да

Логин магазина, полученный при подключении

password

AN..30

да

Пароль магазина, полученный при подключении

В зависимости от выбранной схемы оплаты (одностадийная или двухстадийная) используется различный набор запросов. Ниже описаны запросы для каждой из схем.

Все текстовые поля должны иметь кодировку  Юникод (UTF-8).

Спец-символы в REST запросе должны быть экранированы в соответствии с URL-кодом. Таблица символов представлена здесь: http://web-developer.name/urlcode/. Например, пароль "qwe?rt%y" должен передаваться в виде "qwe%0Frt%25y".

Если код ошибки errorCode=0, запрос был обработан Платежным шлюзом без системных ошибок. При этом errorCode не показывает статус заказа. Для получения статуса заказа следует использовать запрос getOrderStatus или getOrderStatusExtended.

Координаты подключения

URL для доступа к методам REST:

  • Регистрация заказа https://3dsec.sberbank.ru/payment/rest/register.do
  • Регистрация заказа с предавторизацией https://3dsec.sberbank.ru/payment/rest/registerPreAuth.do
  • Запрос завершения оплаты заказа https://3dsec.sberbank.ru/payment/rest/deposit.do
  • Запрос отмены оплаты заказа https://3dsec.sberbank.ru/payment/rest/reverse.do
  • Запрос возврата средств оплаты заказа https://3dsec.sberbank.ru/payment/rest/refund.do
  • Получение статуса заказа https://3dsec.sberbank.ru/payment/rest/getOrderStatus.do
  • Получение статуса заказа https://3dsec.sberbank.ru/payment/rest/getOrderStatusExtended.do
  • Запрос проверки вовлеченности карты в 3DS https://3dsec.sberbank.ru/payment/rest/verifyEnrollment.do
  • Запрос проведения оплаты по связкам https://3dsec.sberbank.ru/payment/rest/paymentOrderBinding.do
  • Запрос деактивации связки https://3dsec.sberbank.ru/payment/rest/unBindCard.do
  • Запрос активации связки https://3dsec.sberbank.ru/payment/rest/bindCard.do
  • Запрос изменения срока действия связки https://3dsec.sberbank.ru/payment/rest/extendBinding.do
  • Запрос списка возможных связок для мерчанта https://3dsec.sberbank.ru/payment/rest/getBindings.do
  • Запрос статистики по платежам за период https://3dsec.sberbank.ru/payment/rest/getLastOrdersForMerchants.do

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

62.76.205.3

порт 443