Открыть мобильную версию сайта Вверх

Бизнес-клиент

Техническая спецификация (до 30.04.2016)

  • На интернет-сервер продавца устанавливаются дополнительные модули, которые обмениваются с банком запросами, а также составляют и проверяют цифровые подписи.
  • Продавец генерирует цифровую подпись и отправляет ее в банк. (eservice@seb.ee).
  • Помощь в установке дополнительных модулей и генерировании цифровой подписи предлагают ИТ-предприятия.  

Описание услуг с платежной функцией

Услуга «1001»
Коммерсант пересылает в банк заявление клиента на осуществление операции.

Наименование поля Длина в символах Описание
1 VK_SERVICE 4 Номер услуги (1001)
2 VK_VERSION 3 Используемый алгоритм шифрования (008)
3 VK_SND_ID 15 ID составителя запроса (ID магазина)
4 VK_STAMP 20 ID запроса
5 VK_AMOUNT 12 Сумма, подлежащая оплате
6 VK_CURR 3 Код валюты: EUR
7 VK_ACC 34 Номер счета получателя
8 VK_NAME 70 Имя получателя
9 VK_REF 35 Номер ссылки платежного поручения
10 VK_MSG 95 Пояснение платежного поручения
- VK_CHARSET 12 Кодировка сообщения. Необязательный параметр.
Допустима ISO-8859-1 (значение по умолчанию) или UTF-8
- VK_MAC 700 Контрольный код или подпись
- VK_RETURN 255 URL или интернет-адрес, куда сообщается об успешном проведении операции
- VK_CANCEL 255 URL или интернет-адрес, куда сообщается о неудавшейся операции
- VK_LANG 3 Предпочитаемый язык общения

Услуга «1002»
Коммерсант пересылает в банк заявление клиента на осуществление операции. Имя получателя платежа и номер его счета берутся из договора, заключенного между банком и коммерсантом.

Наименование поля Длина в символах Описание
1 VK_SERVICE 4 Номер услуги (1002)
2 VK_VERSION 3 Используемый алгоритм шифрования (008)
3 VK_SND_ID 15 ID составителя запроса (ID магазина)
4 VK_STAMP 20 ID запроса
5 VK_AMOUNT 12 Сумма, подлежащая оплате
6 VK_CURR 3 Код валюты: EUR
7 VK_REF 35 Номер ссылки платежного поручения
8 VK_MSG 95 Пояснение платежного поручения
- VK_CHARSET 12 Кодировка сообщения. Необязательный параметр.
Допустима ISO-8859-1 (значение по умолчанию) или UTF-8
- VK_MAC 700 Контрольный код или подпись
- VK_RETURN 255 URL или интернет-адрес, куда сообщается об успешном проведении операции
- VK_CANCEL 255 URL или интернет-адрес, куда сообщается о неудавшейся операции

Услуга «1101»
Ответ об акцептировании операции

Наименование поля Описание
1 VK_SERVICE Номер услуги (1101)
2 VK_VERSION Используемый алгоритм шифрования (008)
3 VK_SND_ID ID составителя запроса (ID банка)
4 VK_REC_ID ID получателя запроса (ID магазина)
5 VK_STAMP ID запроса
6 VK_T_NO Номер платежного поручения
7 VK_AMOUNT Уплаченная сумма
8 VK_CURR Код валюты: EUR
9 VK_REC_ACC Номер счета получателя
10 VK_REC_NAME Имя получателя
11 VK_SND_ACC Номер счета плательщика
12 VK_SND_NAME Имя плательщика
13 VK_REF Номер ссылки платежного поручения
14 VK_MSG Пояснение платежного поручения
15 VK_T_DATE Дата платежного поручения
- VK_CHARSET Кодировка сообщения. Необязательный параметр.
Допустима ISO-8859-1 (значение по умолчанию) или UTF-8
- VK_MAC Контрольный код или подпись
- VK_LANG Предпочитаемые язык общения
- VK_AUTO Указывает на то, был ли пакет отправлен автоматически (`Y`) или нет (`N`)

Услуга «1901»
Ответ об отказе операции

Наименование поля Описание
1 VK_SERVICE Номер услуги (1901)
2 VK_VERSION Используемый алгоритм шифрования (008)
3 VK_SND_ID ID составителя запроса (ID банка)
4 VK_REC_ID ID получателя запроса (ID магазина)
5 VK_STAMP ID запроса
6 VK_REF Номер ссылки платежного поручения
7 VK_MSG Пояснение платежного поручения
- VK_CHARSET Кодировка сообщения. Необязательный параметр.
Допустима ISO-8859-1 (значение по умолчанию) или UTF-8
- VK_MAC Контрольный код или подпись
- VK_LANG Предпочитаемые язык общения
- VK_AUTO Указывает на то, был ли пакет отправлен автоматически (`Y`) или нет (`N`)

Услуга «1902»
Используется для сообщения о неудавшейся операции. Добавляется поле „VK_ERROR_CODE”, которое показывает установленный код ошибки.

Наименование поля Длина в символах Описание
1 VK_SERVICE 4 Номер услуги
2 VK_VERSION 3 Используемый алгоритм шифрования (008)
3 VK_SND_ID 15 ID составителя запроса (ID банка)
4 VK_REC_ID 15 ID получателя запроса (ID магазина)
5 VK_STAMP 20 ID запроса
6 VK_REF 35 Номер ссылки платежного поручения
7 VK_MSG 95 Пояснение платежного поручения
8 VK_ERROR_CODE 4 Пояснение платежного поручения
- VK_CHARSET 12 Кодировка сообщения. Необязательный параметр.
Допустима ISO-8859-1 (значение по умолчанию) или UTF-8
- VK_MAC 700 Контрольный код или подпись
- VK_LANG 3 Предпочитаемый язык общения
- VK_AUTO 1 Указывает на то, был ли пакет отправлен автоматически (`Y`) или нет (`N`)

Пример:
VK_SERVICE=1901&VK_VERSION=002&VK_SND_ID=HP&VK_REC_ID=EPL001&
VK_STAMP=37306e24&_REF=200002086&VK_MSG=Maksekorraldus%3A+Aastatellimus& VK_MAC=g40uYkOzfwH5QhQaKBgNYua%2FxfE%3D&VK_LANG=EST

Пример: нахождение контрольного кода VK_MAC на основе версии 008
Для расчета подписи MAC008 (VK_MAC) используется алгоритм открытого ключа RSA и алгоритм хеширования SHA1.
MAC008(x1,x2,..., xn):= RSA (SHA-1(p(x1) || x1 || p(x2) || x2 || ... || p(xn) || xn),d,n)

Пояснения:
|| – операция сложения компонентов типа stringe
x1, x2, ..., xn - параметры запроса (в спецификации пронумерованы).
p – функция от длины параметра
в байтах. Длина – номер в виде трехзначной строки string.
d RSA - секретная экспонента
n RSA - modulus

Описание услуг аутентификации

Услуга «3001»
Коммерсанту передаются идентификатор пользователя, а также дата и время генерирования пакета.

Наименование поля Длина в символах Описание
1 VK_SERVICE 4 Номер услуги (3001)
2 VK_VERSION 3 Используемый алгоритм шифрования (008)
3 VK_USER 16 Договорный идентификатор пользователя
4 VK_DATE 10 Дата генерирования пакета
5 VK_TIME 8 Время генерирования пакета
6 VK_SND_ID 15 ID составителя запроса (ID банка)
- VK_CHARSET 12 Кодировка сообщения. Необязательный параметр.
Lubatud Допустима ISO-8859-1 (значение по умолчанию) или UTF-8
- VK_MAC 700 Контрольный код или подпись

Услуга «3002»
Коммерсанту передаются идентификатор пользователя, а также дата и время генерирования пакета. Поле „VK_INFO” содержит информацию, которая представлена в оговоренном с коммерсантом виде. Поле может содержать, например, пары, разделенные двоеточием, в виде „NIMI:VÄÄRTUS”.

Наименование поля Длина в символах Описание
1 VK_SERVICE 4 Номер услуги (3002)
2 VK_VERSION 3 Используемый алгоритм шифрования (008)
3 VK_USER 16 Договорный идентификатор пользователя
4 VK_DATE 10 Дата генерирования пакета
5 VK_TIME 8 Время генерирования пакета
6 VK_SND_ID 15 ID составителя запроса (ID банка)
7 VK_INFO 300 Поле, содержащее личные данные пользователя, стандартизируемое по договоренности
- VK_CHARSET 12 Кодировка сообщения. Необязательный параметр.
Допустима ISO-8859-1 (значение по умолчанию) или UTF-8
- VK_MAC 700 Контрольный код или подпись

Услуга «4001»
Пересылаемый продавцом запрос для идентификации пользователя U-Net

Наименование поля Длина в символах Описание
1 VK_SERVICE 4 Информация о представленном запросе
2 VK_VERSION 3 Используемый алгоритм шифрования (008)
3 VK_SND_ID 15 ID составителя запроса (ID партнера)
4 VK_REPLY 4 Код ожидаемого ответного пакета (3002)
5 VK_RETURN 255 URL или интернет-адрес продавца, куда направляется ответ
6 VK_DATE 10 Дата генерирования пакета
7 VK_TIME 8 Время генерирования пакета
  VK_CHARSET 12 Кодировка сообщения. Необязательный параметр.
Допустима ISO-8859-1 (значение по умолчанию) или UTF-8
- VK_MAC 700 Контрольный код или подпись

Услуга «4002»
Пересылаемый продавцом запрос для идентификации пользователя U-Net

Наименование поля Длина в символах Описание
1 VK_SERVICE 4 Номер услуги (4002)
2 VK_VERSION 3 Используемый алгоритм шифрования (008)
3 VK_SND_ID 15 ID составителя запроса (ID партнера)
4 VK_REC_ID 15 ID получателя запроса (ID банка)
5 VK_NONCE 50 Уникальной ключ, сгенерированный отправителем запроса (используется для гарантирования свежести операции)
6 VK_RETURN 255 URL или интернет-адрес, куда направляется аутентифицированный пользователь
- VK_CHARSET 12 Кодировка сообщения. Необязательный параметр.
Допустима ISO-8859-1 (значение по умолчанию) или UTF-8
- VK_MAC 700 Контрольный код или подпись

Услуга «3003»
Продавцу передаются личный код и имя пользователя.

Наименование поля Длина в символах Описание
1 VK_SERVICE 4 Номер услуги (3003)
2 VK_VERSION 3 Используемый алгоритм шифрования (008)
3 VK_SND_ID 15 ID составителя запроса (ID банка)
4 VK_REC_ID 15 ID получателя запроса (ID партнера)
5 VK_NONCE 50 Копия ключа, содержавшегося в запросе
6 VK_INFO 300 Поле, содержащее личные данные аутентифицируемого лица, стандартизируемое по договоренности
- VK_CHARSET 12 Кодировка сообщения. Необязательный параметр.
Допустима ISO-8859-1 (значение по умолчанию) или UTF-8
- VK_MAC 700 Контрольный код или подпись

 

Контакт

S|E|B

Tähelepanu! Teie veebilehtiseja ei vasta SEB kodulehe külastamiseks vajalikele nõuetele. Palun vahetage veebilehitsejat või seadet, millega te veebilehte sirvite.

Attention! Your web browser does not correspond to the requirements needed to visit SEB website. Please change web browser or device that you use for browsing the site.

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