Бизнес-клиент
- Главная страница
- Бизнес-клиент
- Повседневные услуги
- Прием платежей
- Банковская ссылка и услуга аутентификации...
- Техническая спецификация
Техническая спецификация (до 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 | Контрольный код или подпись |