„bank link“ techninės specifikacijos - swedbank.lt · kam tai reikalinga? viena pusė,...

12
„Bank link“ techninės specifikacijos Informacija programuotojams 2017 11 15

Upload: hanhu

Post on 16-Mar-2019

234 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: „Bank link“ techninės specifikacijos - swedbank.lt · Kam tai reikalinga? Viena pusė, siųsdama pranešimą kitai, pasirašo jį slaptuoju raktu, o kita pusė, turėdama atitinkamą

„Bank link“ techninės specifikacijos

Informacija programuotojams

2017 11 15

Page 2: „Bank link“ techninės specifikacijos - swedbank.lt · Kam tai reikalinga? Viena pusė, siųsdama pranešimą kitai, pasirašo jį slaptuoju raktu, o kita pusė, turėdama atitinkamą

Turinys

Paslaugos veikimo principai ........................................................................................................................ 3

Užklausos................................................................................................................................................. 3

Prekybininko užklausos, siunčiamos bankui ............................................................................................ 3

Banko užklausos, siunčiamos prekybininkui ........................................................................................... 3

Užklausų specifikacijos ................................................................................................................................ 4

Užklausa „1002“ ...................................................................................................................................... 4

Užklausa „1101“ ...................................................................................................................................... 4

Užklausa „1901“ ...................................................................................................................................... 5

Užklausų elektroninis pasirašymas ............................................................................................................... 6

Raktų generavimas ................................................................................................................................... 6

Kam tai reikalinga? .................................................................................................................................. 6

Kokie duomenys turi būti sertifikato užklausoje? .................................................................................... 6

Raktų ir sertifikatų užklausų pavyzdžiai .................................................................................................. 7

VK_MAC kontrolinio kodo apskaičiavimas .......................................................................................... 10

Banko logotipo ir nuorodų naudojimas ...................................................................................................... 11

2

Page 3: „Bank link“ techninės specifikacijos - swedbank.lt · Kam tai reikalinga? Viena pusė, siųsdama pranešimą kitai, pasirašo jį slaptuoju raktu, o kita pusė, turėdama atitinkamą

Paslaugos veikimo principai

Užklausos

Užklausos yra HTTP GET arba POST užklausos su nurodytais parametrais. Kiekvienoje užklausoje nurodomas

paslaugos numeris. Kiekviena paslauga turi unikalų parametrų sąrašą ir savo algoritmą užklausoms tvarkyti.

Paslaugos numeris iš esmės atitinka algoritmo, kurio pagalba tvarkoma užklausa, numerį. Į visus kitus

parametrus, kurių laukelių pavadinimai neprasideda „VK_“, neatsižvelgiama.

Nurodant parametrų dydžius dešimtainėms skaičiaus dalims atskirti, naudojamas taškas. Tūkstančiams

atskirti ženklai nenaudojami.

Datoms nurodyti naudojamas šis formatas: „DD.MM.YYYY“, pvz., 17.02.2001.

Paros laikui nurodyti naudojamas šis formatas: „hh24:min:sek“, pvz., 17:02:59.

Parametro reikšmės skaičius negali būti ilgesnis nei nustatyta specifikacijose. Priešingu atveju užklausa

nebus apdorojama.

Parametrų verčių skaičius gali būti trumpesnis už leistiną maksimalų ilgį. Praleistos tuščios vietos

nepildomos. Tarpeliai prieš parametro reikšmės skaičių ir po jo neskaičiuojami.

Atsakant į specifikacijų neatitinkančias ir negaliojančias užklausas, siunčiamas klaidos pranešimas.

Operacijos, kurios turi būti atliktos pagal užklausą, vykdomos laikantis bendrųjų paslaugos reikalavimų

(mokėjimo pavedimų ir kt. reikalavimų).

Prekybininkas nurodo užklausos koduotę, naudodamas VK_ENCODING parametrą. Galima naudoti tik UTF-

8 ir ISO-8859-13 koduotes. Atsakymams bankas visada naudoja prekybininko nurodytą koduotę. Jeigu

koduotė konkrečiai nenurodyta, pagal nutylėjimą naudojama ISO-8859-13.

Pagal pateikėją užklausos skirstomos į prekybininko arba banko užklausas. Be to, jas galima skirstyti į

užklausas, į kurias reikia atsakyti, ir užklausas, į kurias nereikia atsakyti.

Prekybininko užklausos, siunčiamos bankui

Prekybininko užklausų, siunčiamų bankui, paskirtis yra informuoti klientą ir (arba) padėti jam atlikti operaciją, pvz.,

mokėjimo pavedimą. Pagal vieną užklausą suteikiama viena paslauga. Pateikti parametrai tikrinami ir tvirtinami,

atsižvelgiant į paslaugos tipą. Užklausos parametrų sąrašas ir eiliškumas priklauso nuo naudojamos paslaugos.

Bankas atsako į paklausimus, į kuriuos reikia atsakyti, užbaigus kliento operaciją.

Paprastai atsakyme nurodomi operacijos duomenys ir informuojama, ar ji buvo atlikta sėkmingai.

Prekybininko užklausos bankui nukreipiamos į URL:

https://ib.swedbank.lt/banklink

Banko užklausos, siunčiamos prekybininkui

Banko užklausos, siunčiamos prekybininkui, paprastai būna atsakymai į ankstesnes prekybininko užklausas.

3

Page 4: „Bank link“ techninės specifikacijos - swedbank.lt · Kam tai reikalinga? Viena pusė, siųsdama pranešimą kitai, pasirašo jį slaptuoju raktu, o kita pusė, turėdama atitinkamą

Užklausų specifikacijos

URL parametrų VK_RETURN laukelyje naudoti negalima.

Užklausa „1002“

Prekybininkas siunčia bankui pasirašyto mokėjimo pavedimo duomenis, kurių klientas interneto banke

pakeisti negali. Jeigu mokėjimo pavedimas pateikiamas sėkmingai, prekybininkui parengiama užklausa

„1101“, o jeigu nesėkmingai – užklausos paketas „1901“. Gavėjo duomenys imami iš „Bank link“ sutarties.

Nr. Laukelis Ilgis Aprašymas

1 VK_SERVICE 4 Paslaugos numeris (1002)

2 VK_VERSION 3 Naudojamas šifravimo algoritmas (008)

3 VK_SND_ID 10 Užklausos rengėjo (prekybininko) ID

4 VK_STAMP 20 Užklausos ID prekybininko sesijos tęstinumui užtikrinti

5 VK_AMOUNT 17 Mokėtina suma

6 VK_CURR 3 Valiutos pavadinimas ISO 4217 formatu (EUR etc.)

7 VK_REF 20 Mokėjimo pavedimo įmokos kodas

8 VK_MSG 300 Mokėjimo pavedimo paskirtis

- VK_MAC 700 Kontrolinis kodas arba parašas

- VK_RETURN 150 URL, į kurį siunčiamas operacijos užklausos atsakymas (1101, 1901)

- VK_LANG 3 Pasirinkta komunikacijos kalba (LIT, ENG arba RUS)

- VK_ENCODING - Žinutės koduotė. ISO- 8859-13 (pagal nutylėjimą) arba UTF-8

Užklausa „1101“

Naudojama pateikiant atsakymą apie sėkmingai atliktą vietinį mokėjimo pavedimą.

Nr. Laukelis Ilgis Aprašymas

1 VK_SERVICE 4 Paslaugos numeris (1101)

2 VK_VERSION 3 Naudojamas šifravimo algoritmas (008)

3 VK_SND_ID 10 Užklausos rengėjo (banko) ID

4 VK_REC_ID 10 Užklausos gavėjo (prekybininko) ID

5 VK_STAMP 20 Užklausos ID prekybininko sesijos tęstinumui užtikrinti

6 VK_T_NO 300 Mokėjimo pavedimo numeris

7 VK_AMOUNT 17 Sumokėta suma

8 VK_CURR 3 Valiutos pavadinimas ISO 4217 formatu (EUR etc.)

9 VK_REC_ACC 34 Gavėjo sąskaitos numeris

10 VK_REC_NAME 70 Gavėjo pavadinimas

11 VK_SND_ACC 34 Mokėtojo sąskaitos numeris

4

Page 5: „Bank link“ techninės specifikacijos - swedbank.lt · Kam tai reikalinga? Viena pusė, siųsdama pranešimą kitai, pasirašo jį slaptuoju raktu, o kita pusė, turėdama atitinkamą

12 VK_SND_NAME 40 Mokėtojo pavadinimas

13 VK_REF 20 Mokėjimo pavedimo įmokos kodas

14 VK_MSG 300 Mokėjimo pavedimo paskirtis

15 VK_T_DATE 10 Mokėjimo pavedimo pateikimo data

- VK_MAC 300 Kontrolinis kodas arba parašas

- VK_LANG 3 Pasirinkta komunikacijos kalba (LIT, ENG arba RUS)

- VK_AUTO 1 Y= yra banko automatiškai siunčiamas atsakymas. N= yra atsakymas, siunčiant klientą iš

banko puslapio į prekybininko puslapį

- VK_ENCODING - Žinutės koduotė. ISO- 8859-13 (pagal nutylėjimą) arba UTF-8

Užklausa „1901“

Siunčiama, kai reikia pranešti apie nesėkmingą operaciją.

Nr. Laukelis Ilgis Aprašymas

1 VK_SERVICE 4 Paslaugos numeris (1901)

2 VK_VERSION 3 Naudojamas šifravimo algoritmas (008)

3 VK_SND_ID 10 Užklausos rengėjo (banko) ID

4 VK_REC_ID 10 Užklausos rengėjo (prekybininko) ID

5 VK_STAMP 20 Užklausos ID prekybininko sesijos tęstinumui užtikrinti

6 VK_REF 20 Mokėjimo pavedimo įmokos kodas

7 VK_MSG 300 Mokėjimo pavedimo paskirtis

- VK_MAC 300 Kontrolinis kodas arba parašas

- VK_LANG 3 Pasirinkta komunikacijos kalba (LIT, ENG arba RUS

- VK_AUTO 1 N= yra atsakymas, siunčiant klientą į prekybininko puslapį

- VK_ENCODING - Žinutės koduotė. ISO- 8859-13 (pagal nutylėjimą) arba UTF-8

5

Page 6: „Bank link“ techninės specifikacijos - swedbank.lt · Kam tai reikalinga? Viena pusė, siųsdama pranešimą kitai, pasirašo jį slaptuoju raktu, o kita pusė, turėdama atitinkamą

Užklausų elektroninis pasirašymas

Raktų generavimas

Pagal bendrus atvejus, raktų sukūrimo procedūra atrodo taip:

1. Klientas sukuria savo viešojo ir slaptojo rakto porą; be to suformuojama sertifikato užklausa

(„certificate request“), į kurios sudėtį įeina viešasis raktas (komerciniai „web“ serveriai dažnai turi

priemones raktams generuoti).

2. Klientas nusiunčia sertifikato užklausą mums.

3. Mes pasirašome jų užklausą savo raktu ir suformuojame sertifikatą.

Kam tai reikalinga?

Viena pusė, siųsdama pranešimą kitai, pasirašo jį slaptuoju raktu, o kita pusė, turėdama atitinkamą viešąjį raktą

(pusę poros), gali patikrinti, ar pranešimas nėra pakeistas. Autorizacijos centrai nenaudojami, mes patys esame

sertifikavimo organizacija („certificate authority“).

Kokie duomenys turi būti sertifikato užklausoje?

Sertifikatui gauti reikalinga kliento sertifikato užklausa su šiais duomenimis:

C=LT (šalis)

L=<Vietove> (pvz., Kaunas)

O=<Organizacija> (Organizacija)

OU=BankLink

CN=<serverio vardas> (pvz., banklink-server.organizacija.lt>

E=<kontaktinis e-mail>

Jei kažkurios reikšmės užklausoje nebus galima uždėti, informuokite apie tai banką.

Jei neturite „Bank link“ raktams generuoti reikiamos programinės įrangos, bankas siūlo naudoti OpenSSL,

kuris yra pakankamai dažnai atnaujinamas nemokamas kriptografijos įrankių rinkinys.

OpenSSL pasiekiamas iš http://www.openssl.org.

Kompiliuotą OpenSSL versiją galima gauti iš http://www.modssl.org/contrib/, tačiau naudoti ją siūlome tik

tada, jei jūs pasitikite minėtuoju interneto puslapiu.

Sukūrę savo slaptąjį raktą ir viešąjį raktą (sertifikato užklausą), pastarąjį atsiųskite bankui pasirašyti.

6

Page 7: „Bank link“ techninės specifikacijos - swedbank.lt · Kam tai reikalinga? Viena pusė, siųsdama pranešimą kitai, pasirašo jį slaptuoju raktu, o kita pusė, turėdama atitinkamą

Rakto ir sertifikato užklausos generavimas (OpenSSL):

openssl req -new -config <Kelias iki openssl.cnf> -out cert_request.pem -keyout private_key.pem

- Jūsų paklaus slaptažodžio slaptajam raktui.

- Jūsų paklaus duomenų sertifikato užklausai.

Peržiūrėti sertifikato užklausą galite:

openssl req -in cert_request.pem -text -noout

Išsaugoti privatų raktą nešifruota forma galite:

openssl rsa -in private_key.pem -out new_private_key.pem

Pakeisti privataus rakto šifravimo slaptažodį galite:

openssl rsa -in private_key.pem -3des -out new_private_key.pem

Peržiūrėti SSL sertifikatą galite:

openssl x509 -in cert.pem -text -noout

Pavyzdys, kaip sugeneruoti sertifikato užklausą:

http://www.modssl.org/docs/2.8/ssl_faq.html#ToC28

Raktų ir sertifikatų užklausų pavyzdžiai

Slaptasis RSA raktas, nešifruotas:

-----BEGIN RSA PRIVATE KEY-----

MIICXgIBAAKBgQCvqlkOMrYxGw85j7rkF+KNChajMJL+o6pwGK2bt1IRP/VQxWyB

4AqrljzcUDn1wWTmEzISEJqxF9t/WN8jWcdFCO1Zws5inYt0+WZqkZW+MXVCf+8g

sn8Tbdt7C69++ZH6MUqjJj+Q5EjauchXDmPWPg2v07HBZBIvAhTFDVE1ZwIDAQAB

AoGAMj3OarkmUrUijZwGH+aU7THNd68U26+Dt7vXK4oq9rQMPaW5ewvRAXJexcRM

T3WYnhUvZOtK0wu3w5xvdXTgAOz+Y7ZIIziQCut0+Uy4QERLnKGXZ4830DDh+M7m

oXeF3e+Eur4vx6Whg38jbZs+WyaRJqB2DgNnHhtakyZb/IECQQDkr2KKE6GSJT8h

FXih5Ux2boiN85ehZmN9Maprxviz3V90leyINL6dXapmBDBXClGV2QCDDOMqMEcw

nfqI31HJAkEAxKXBLrvveJ3G5YnOL0IhlGdpBURJtr7h3Pd6E9exdLJ0NBesaour

oj7eJ0+5CSHtCz9ST7S7WgtnguVGaERlrwJBANe8ZRehgXEf1jhdyxnf+YxYplZU

ER3gO8cljYJziLgWBTE1JpkwOQq4DEKFfRz/zQuyVftLsxpfxSkmP+3Tz5ECQQCs

f75rkX5qrvS3i9/rQraUKPZOIW4MOXuFyy0yVMYc2SHoRFABko23oDBeCagGI9V9

RUmeE6s5PMHLZ/YQJtePAkEAn/0DCozbYbz+xlGwhg7kHvH0LqCB6sITxfzMaFQb

T8EGmloj4wIkgvEImgBTyJ3xIZulcDwFpT9qApIKmcCm3Q==

-----END RSA PRIVATE KEY-----

7

Page 8: „Bank link“ techninės specifikacijos - swedbank.lt · Kam tai reikalinga? Viena pusė, siųsdama pranešimą kitai, pasirašo jį slaptuoju raktu, o kita pusė, turėdama atitinkamą

Tas pat slaptasis RSA raktas, užšifruotas slaptažodžiu „kala“ (be kabučių):

-----BEGIN RSA PRIVATE KEY-----

Proc-Type: 4,ENCRYPTED

DEK-Info: DES-EDE3-CBC,E6C541BC0138209A

UM49jAy/j7b1JTcuaWJzseIQBk+P7ZOWI6Wp9myGiDk+0+AVj4klNaNOWiH1L3kT

Fma3rOuKGF80ntoPNWcjEcLgK4Zjte026XXcr2w/yM1E8yVlmjVcrLAjR1l9bfe1

rKigDJVEsyUjGDI61rDcfEAbCSO/E5nl4P0M139PeV4paoG03VnvALNQcmI30gHW

BhDK9T2kpwG2rz1ATTf30e7GzpMWvpd7ONMV+39flHAMg7IgRy3GBbERjrwsalxr

dCMdhYyGvrnrBDQDmKuV95jZJu8siTeFDKlFINRS7DsLmhYXCIj50wOUizPLKvxV

dFvAZLiEVXWJ8UoZMn1+QYPNrEty1ox/0rFVM4o1rxK6zSyDoMAoNH6ynoWlLGDx

+nokFgobIWXvKZ2zHhm4+TUbF1cavOXX45yZ837/7udgDnQQ4P02vqpgI0w3oVGG

+5S4gU4ZCjUaax3L3UDAgYRagPY9kJGYcSiJ3399j6gUgcin7ebFAAhfKsi6ioRQ

GadiqhlACMKs30H2oxXJ+4rjNIP6zKlHvkYb3HFrpKOGdArN9KEX7qrOkWDpQaLS

pNlTjR1rKbzsLoqk9cbnRINf+8/Y0BHtnmhISmR0AM4uKYiAfcoCtwwfXMWG5oFT

OMF9oVCGLXFlNpPA60PpLvfYEwZuSEuLr2kJAMOfkSeJyDbInbztwKERRaB2LikC

LxGvpBBphCf48fR8EIQSN9VH7fSLLd3DohkLi5XupUZxxp58TG2WyqBz0isQPfp0

wGvz5ATJ5xtZQ6thrIZlayKV40zUiDSXu9N6ugRG/YJLCncaw8xrWg==

-----END RSA PRIVATE KEY-----

Sertifikato užklausa, PEM formate:

-----BEGIN CERTIFICATE REQUEST-----

MIIB+TCCAWICAQAwgY8xCzAJBgNVBAYTAkxUMRAwDgYDVQQHEwdWaWxuaXVzMRww

GgYDVQQKExNBQiBiYW5rYXMgSGFuc2EtTFRCMREwDwYDVQQLEwhCYW5rTGluazEa

MBgGA1UEAxMRYmFua2xpbmsuaGFuc2EubHQxITAfBgkqhkiG9w0BCQEWEndlYm1h

c3RlckBoYW5zYS5sdDCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAr6pZDjK2

MRsPOY+65BfijQoWozCS/qOqcBitm7dSET/1UMVsgeAKq5Y83FA59cFk5hMyEhCa

sRfbf1jfI1nHRQjtWcLOYp2LdPlmapGVvjF1Qn/vILJ/E23bewuvfvmR+jFKoyY/

kORI2rnIVw5j1j4Nr9OxwWQSLwIUxQ1RNWcCAwEAAaApMCcGCSqGSIb3DQEJDjEa

MBgwCQYDVR0TBAIwADALBgNVHQ8EBAMCBPAwDQYJKoZIhvcNAQEEBQADgYEALdf7

7J/GLfGZE27vXRLJrqAvjZeeV3/QlJMQTjhFihVb8N9h6Z+s7e+VbgEpKq5feVot

gbN8oPPbSYC0TVPOdRpKIi7+IzfVWWFgSZxUGKqdkypaGcRM4qa+wgPFsUi6syhZ

c5gJDvcjp+lEUvOett2/KT7KLFiQs9o/glY8PEI=

-----END CERTIFICATE REQUEST----- Ta pati sertifikato užklausa, tekstiniame formate:

Certificate Request:

Data:

Version: 0 (0x0)

Subject: C=LT, L=Vilnius, O=Swedbank AB, OU=BankLink,

8

Page 9: „Bank link“ techninės specifikacijos - swedbank.lt · Kam tai reikalinga? Viena pusė, siųsdama pranešimą kitai, pasirašo jį slaptuoju raktu, o kita pusė, turėdama atitinkamą

CN=ib.swedbank.lt/[email protected]

Subject Public Key Info:

Public Key Algorithm: rsaEncryption

RSA Public Key: (1024 bit)

Modulus (1024 bit):

00:af:aa:59:0e:32:b6:31:1b:0f:39:8f:ba:e4:17:

e2:8d:0a:16:a3:30:92:fe:a3:aa:70:18:ad:9b:b7:

52:11:3f:f5:50:c5:6c:81:e0:0a:ab:96:3c:dc:50:

39:f5:c1:64:e6:13:32:12:10:9a:b1:17:db:7f:58:

df:23:59:c7:45:08:ed:59:c2:ce:62:9d:8b:74:f9:

66:6a:91:95:be:31:75:42:7f:ef:20:b2:7f:13:6d:

db:7b:0b:af:7e:f9:91:fa:31:4a:a3:26:3f:90:e4:

48:da:b9:c8:57:0e:63:d6:3e:0d:af:d3:b1:c1:64:

12:2f:02:14:c5:0d:51:35:67

Exponent: 65537 (0x10001)

Attributes:

Requested Extensions:

X509v3 Basic Constraints:

CA:FALSE X509v3

Key Usage:

Digital Signature, Non Repudiation, Key Encipherment, Data Encipherment

Signature Algorithm: md5WithRSAEncryption

2d:d7:fb:ec:9f:c6:2d:f1:99:13:6e:ef:5d:12:c9:ae:a0:2f:

8d:97:9e:57:7f:d0:94:93:10:4e:38:45:8a:15:5b:f0:df:61:

e9:9f:ac:ed:ef:95:6e:01:29:2a:ae:5f:79:5a:2d:81:b3:7c:

a0:f3:db:49:80:b4:4d:53:ce:75:1a:4a:22:2e:fe:23:37:d5:

59:61:60:49:9c:54:18:aa:9d:93:2a:5a:19:c4:4c:e2:a6:be:

c2:03:c5:b1:48:ba:b3:28:59:73:98:09:0e:f7:23:a7:e9:44:

52:f3:9e:b6:dd:bf:29:3e:ca:2c:58:90:b3:da:3f:82:56:3c:

3c:42

9

Page 10: „Bank link“ techninės specifikacijos - swedbank.lt · Kam tai reikalinga? Viena pusė, siųsdama pranešimą kitai, pasirašo jį slaptuoju raktu, o kita pusė, turėdama atitinkamą

„Swedbank“, AB „Bank Link“ sertifikatas:

-----BEGIN CERTIFICATE-----

MIIEDjCCAvagAwIBAgITVwAAAh/PBfcG6yBi9gAAAAACHzANBgkqhkiG9w0BAQUF

ADBOMQswCQYDVQQGEwJTRTEXMBUGA1UEChMOU3dlZGJhbmsgR3JvdXAxJjAkBgNV

BAMTHVN3ZWRiYW5rIEczIElzc3VpbmcgQ0EgVGllciBBMB4XDTE3MTEwNjA5MTAw

OVoXDTIwMTEwNTA5MTAwOVowODELMAkGA1UEBhMCTFQxETAPBgNVBAoTCFN3ZWRi

YW5rMRYwFAYDVQQDEw1CYW5rbGluayBIb3N0MIGfMA0GCSqGSIb3DQEBAQUAA4GN

ADCBiQKBgQDRaR94bIp05bc/o2ccvWmwuUEfN1WFUPL0wMXN1Wv1rWX68ay7liS/

LBzc3gBq9ungBLlFfaYxBohcJf43gNiZPzdUkBcXJnTeDZxdUzuRuzHA+JOyWqbt

4lcZ4K1l405LJsl5qaXApendeftIN2RpcCK/59Oqyu6thK05JB1HRQIDAQABo4IB

fTCCAXkwHQYDVR0OBBYEFGT0PNTdXiM+/v9Yd2xGD1qDoYdzMB8GA1UdIwQYMBaA

FAihXNOvBjSLItpZ/Qg6KAQ9wIRpMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly9p

bmZyYS5zd2VkYmFuay5jb20vcGtpL2NybC9Td2VkYmFua19HM19Jc3N1aW5nX0NB

X1RpZXJfQS5jcmwwXwYIKwYBBQUHAQEEUzBRME8GCCsGAQUFBzAChkNodHRwOi8v

aW5mcmEuc3dlZGJhbmsuY29tL3BraS9jcnQvU3dlZGJhbmtfRzNfSXNzdWluZ19D

QV9UaWVyX0EuY3J0MAsGA1UdDwQEAwIHgDA9BgkrBgEEAYI3FQcEMDAuBiYrBgEE

AYI3FQiD+8FigsjKGYf1jQeCwoAkgebsfGCCo+dNg/3yXAIBZAIBAzAVBgNVHSUE

DjAMBgorBgEEAYI3CgMMMB0GCSsGAQQBgjcVCgQQMA4wDAYKKwYBBAGCNwoDDDAN

BgkqhkiG9w0BAQUFAAOCAQEAPLcOnG0E3TH6w7wNu8TMsHGAy5jVo/KDQIwnFc1r

Wib679AWpNLkW9aiVghs+9xa+7Al2JFO83fbAwnwSCacif4UGodmdj7drAwwINsI

m4QiMBRY0c34FmokUxB88N8G/+qzKLMMZDL7ljEWtz8KZY31If4RTXTylMcLpU1r

2Y9lH/HH+fr+5wDXt/t+ikvbc2tEH6b+rByfjts7CGMXThb9QLRHnz5WwihYHmiC

iaXXIZr5BBYjzTQIgv9GD0JziRvhaD28Oeym394ICzxZJl3XzG25dY2KJNm1HWLu

u8n2e1CNTanCBA1Bv1S4V0OdyidLaTuJZ0y7ODa3+8trFQ==

-----END CERTIFICATE-----

VK_MAC kontrolinio kodo apskaičiavimas

VK_MAC, elektroniniam parašui, naudojamam užklausoje, tikrinti ir tvirtinti naudojama suderinta algoritmo

versija, nurodyta parametre VK_VERSION. Šiuo metu naudojama 008 versija.

VK_MAC pateikiamas kaip užklausos reikšmės parametras BASE64 koduotėje.

Naudojama versija MAC008

MAC008 funkcijos reikšmė skaičiuojama naudojant viešojo rakto algoritmą RSA. Taip pat reikia atsižvelgti ir į tuščių

laukelių reikšmes – „000“.

MAC008(x1,x2,…,xn) := RSA( SHA-1(p(x1 )|| x1|| p(x2 )|| x2 || … ||p( xn )||xn),d,n)

Čia:

|| – eilučių seka.

x1, x2, …, xn – užklausos parametrai.

p – parametro skaičiaus ilgio funkcija. Ilgis nurodomas trijų skaitmenų eilutės forma.

d – slapta RSA eksponentė.

n – RSA modulis.

Parašas yra apskaičiuojamas pagal PKCS1 standartą (RFC 2437).

10

Page 11: „Bank link“ techninės specifikacijos - swedbank.lt · Kam tai reikalinga? Viena pusė, siųsdama pranešimą kitai, pasirašo jį slaptuoju raktu, o kita pusė, turėdama atitinkamą

Pavyzdys

Tarkime, kad užklausos parametrai yra tokie:

VK_SERVICE=1002

VK_VERSION=008

VK_SND_ID=UAB ĮMONĖ

VK_STAMP=1234567890

VK_AMOUNT=121.99

VK_CURR=EUR

VK_REF=01012001-001

VK_MSG=Apmokėjimas už prekę XXXXXX

Parašas apskaičiuojamas pagal toliau pateiktą duomenų eilutę, kurią sudaro šie elementai (parametro

reikšmių simbolių skaičius ir paties parametro reikšmė):

„0041002“

„003008“

„009UAB ĮMONĖ“

„0101234567890“

„006121.99“

„003EUR“

„01201012001-001“

„027Apmokėjimas už prekę XXXXXX“

Vienoje eilutėje:

„0041002003008009UAB ĮMONĖ 0101234567890006121.99003EUR01201012001-001027

Apmokėjimas už prekę XXXXXX“.

Arba, jeigu VK_REF parametras nenurodytas, pagal rezultatą:

„0041002003008009UAB ĮMONĖ 0101234567890006121.99003EUR000027 Apmokėjimas už prekę

XXXXXX“.

Banko logotipo ir nuorodų naudojimas

Prekybininkas interneto parduotuvėje patalpina banko bendrus reikalavimus atitinkantį *.gif, kuris informuoja apie

galimybę atsiskaityti per „Swedbank“, ir kuris tuo pat metu atlieka nuorodos funkcijas bei nukreipia klientą į banko

nurodytą interneto tinklalapį, kuriame klientas gali susipažinti su banko teikiama „Bank link“ paslauga. Ši nuoroda

turi nukreipti į tokį banko URL:

http://www.swedbank.lt/lt/pages/verslo/banklink.

„Swedbank“ logotipas susideda iš dviejų dalių: žodžio „Swedbank“ ir simbolio, kuriame pavaizduotas

ąžuolas. Šios abi dalys visada turi būti naudojamos kartu.

11

Page 12: „Bank link“ techninės specifikacijos - swedbank.lt · Kam tai reikalinga? Viena pusė, siųsdama pranešimą kitai, pasirašo jį slaptuoju raktu, o kita pusė, turėdama atitinkamą

Prekybininkas įsipareigoja naudoti šiuos banko bendrus reikalavimus atitinkančius *.gif:

1. Grafinė byla (spalvotas banko logotipas), kurios pavadinimas „logotyp_webb_100x22.gif“, *.gif dydis –

100X22 pikselių, grafinė raiška – 96 dpi:

.

2. Grafinė byla (spalvotas banko logotipas), kurios pavadinimas „logotyp_webb_150x34.gif“, *.gif dydis –

150X34 pikselių, grafinė raiška – 96 dpi:

.

3. Grafinė byla (spalvotas banko logotipas), kurios pavadinimas „logotyp_webb_180x40.gif“, *.gif dydis –

180X40 pikselių, grafinė raiška – 96 dpi:

.

Visuomet reikia naudoti spalvotą logotipą ir visuomet baltame arba juodame fone. Jeigu fonas spalvotas arba

margas, po logotipu būtina uždėti stačiakampio formos juodą arba baltą foną.

12