Swedbank Pieslēgšana

Lai izmantotu Swedbank Gateway integrāciju Business Central, nepieciešams veikt vairākus soļus gan bankas pusē, gan Developer portālā. Šī instrukcija apraksta pilnu procesu no līguma noslēgšanas līdz pirmajam veiksmīgajam savienojumam.

Katrs klients noslēdz savu līgumu ar Swedbank un saņem savus pieslēguma datus. JEMEL nodrošina tikai BC integrācijas risinājumu - nevis starpnieka pakalpojumu.

---

1. solis — Noslēgt Swedbank Gateway līgumu

1. Sazinieties ar savu Swedbank kontaktpersonu vai apmeklējiet Swedbank Gateway informācijas lapu

2. Pieprasiet Swedbank Gateway pakalpojuma līgumu

3. Pēc līguma noslēgšanas saņemsiet:

   • X-Agreement-ID — unikāls līguma identifikators (ciparu kods, piemēram, 1234)

   • Instrukcijas transporta sertifikāta izveidei

Līguma noslēgšana var aizņemt dažas darba dienas. Agreement ID ir nepieciešams visiem turpmākajiem soļiem.

---

2. solis — Iegūt transporta sertifikātu

Transporta sertifikāts (pfx/p12 formātā) nodrošina drošu savienojumu starp Business Central un Swedbank API (mTLS autentifikācija).

Sertifikāta prasības

Parametrs	Vērtība
Key Usage	Digital Signature, Key Encipherment
Extended Key Usage	Client Authentication
Key Size	2048 bit (minimums)
Formāts	pfx / p12 (ar privāto atslēgu)

Kā iegūt sertifikātu

1. Pieprasiet no Swedbank CN (Common Name) vērtību sertifikāta pieprasījuma (CSR) izveidei

2. Izveidojiet CSR ar norādīto CN vērtību, izmantojot savu rīku (piemēram, OpenSSL):

   openssl req -new -newkey rsa:2048 -nodes -keyout private.key -out request.csr -subj "/CN=<CN no Swedbank>"

3. Nosūtiet CSR failu Swedbank

4. Saņemiet parakstīto sertifikātu no Swedbank

5. Apvienojiet sertifikātu un privāto atslēgu pfx failā:

   openssl pkcs12 -export -out certificate.pfx -inkey private.key -in certificate.crt

Saglabājiet privāto atslēgu un pfx failu drošā vietā. Ja privātā atslēga tiek kompromitēta, nekavējoties informējiet banku, lai bloķētu sertifikātu.

Sertifikāta derīguma termiņš

• Sertifikāts ir derīgs noteiktu laika periodu

• Pirms termiņa beigām nepieciešams saņemt jaunu sertifikātu un informēt banku

• Ieteicams uzstādīt atgādinājumu 30 dienas pirms derīguma termiņa beigām

Atbalstītie sertifikātu izdevēji Latvijā

• LVRTC (eParaksts) — https://www.eparaksts.lv/en/

• SK ID Solutions AS (Igaunija) — http://www.sk.ee

• Registrų centras (Lietuva) — http://www.registrucentras.lt

---

3. solis — Reģistrēties Swedbank Developer portālā

1. Apmeklējiet https://developer.swedbank.com

2. Izveidojiet kontu (vai piesakieties esošajā)

3. Izveidojiet jaunu Application (lietojumprogrammu):

   • Nosaukums — jūsu uzņēmuma nosaukums

   • E-pasts — kontaktpersonas e-pasts

[Screenshot: image-20260413-144637.png]

4. Pievienojiet API:

   1. SGW API — produkcijas videi

   2. SGW Sandbox — testa videi (pēc izvēles)

[Screenshot: image-20260413-144736.png]

Sandbox un produkcijas vidēm nepieciešamas atsevišķas Application reģistrācijas ar atšķirīgām API atslēgām.

---

4. solis — Izveidot API atslēgu

1. Developer portālā atveriet savu Application

2. Izveidojiet API Key ar šādiem parametriem:

   • Scope: SGW

   • Type: Confidential

[Screenshot: image-20260413-145024.png]

3. Saglabājiet API Key (client_id) — tas būs nepieciešams BC iestatījumos

API Key tiek parādīts tikai vienu reizi. Saglabājiet to drošā vietā.

---

5. solis — Augšupielādēt sertifikātu Developer portālā

1. Developer portālā atveriet savu Application → Overview

2. Laukā QWAC ievadiet transporta sertifikāta publisko daļu (PEM formātā)

[Screenshot: image-20260413-145532.png]

3. Saglabājiet izmaiņas

---

6. solis — Aktivizēt produkcijas piekļuvi

1. Publicējiet savu Application Developer portālā

2. Nosūtiet e-pastu uz SGW.API_Maintenance@swedbank.com ar aktivizācijas pieprasījumu. E-pastā noradīet:

   1. API Key (client_id) (4. solis)

   2. Application name (3. solis)

3. Swedbank aktivizēs piekļuvi 1-3 darba dienu laikā

Sandbox videi aktivizācija nav nepieciešama — tā ir pieejama uzreiz pēc Application izveidošanas.

---

Kopsavilkums — ko jūs saņemsiet

Pēc visu soļu izpildes jums būs:

Parametrs	Avots	Kur ievadīt BC
Transporta sertifikāts (pfx/p12)	No Swedbank (CSR process)	Bankas konta kartiņa → Bank Gateway cilne → Augšupielādēt sertifikātu
Sertifikāta parole	Jūs uzstādījāt, veidojot pfx	Tiek pieprasīta augšupielādes laikā
Agreement ID	No Swedbank līguma	Bankas konta kartiņa → Bank Gateway cilne → Līguma ID
API Key (client_id)	No Developer portāla	Bankas konta kartiņa → Bank Gateway cilne → API atslēga

Nākamais solis — iestatīt Gateway Business Central vidē. Skatīt sadaļu Iestatījumi Business Central.