> For the complete documentation index, see [llms.txt](https://docs.ecommerce.seb.ee/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ecommerce.seb.ee/seb-docs-draft/seb-docs-public-et/alustamine/integratsiooninimekiri.md).

# Integratsiooninimekiri

See juhend viib teid läbi SEB e-kaubanduse makselüüsi täieliku integratsiooniprotsessi — alates kaupmehe liitmisest kuni esimese reaalajas tehingu töötlemiseni.

## Keskkonna viide

See **SEB e-kaubanduse makselüüs** pakub eraldi test- ja tootmiskeskkondi koos kaupmeestele mõeldud tugiteenustega.

| Teenus                                        | Aadress                                   |
| --------------------------------------------- | ----------------------------------------- |
| **Kaupmehe portaal**                          | `merchantportal.ecommerce.sebgroup.com`   |
| **Kaupmehe dokumentatsioon**                  | `docs.ecommerce.sebgroup.com`             |
| **Kaupmehe API — testkeskkond**               | `sandbox.api.ecommerce.sebgroup.com`      |
| **Kaupmehe API — tootmiskeskkond**            | `api.ecommerce.sebgroup.com`              |
| **Majutatud kassalahendus — testkeskkond**    | `sandbox.checkout.ecommerce.sebgroup.com` |
| **Majutatud kassalahendus — tootmiskeskkond** | `checkout.ecommerce.sebgroup.com`         |
| **Teenuse olek**                              | `status.ecommerce.sebgroup.com`           |

{% hint style="info" %}
Test- ja tootmiskeskkonnad on eraldi keskkonnad. Kasuta alati API lõpp-punkti, mandaate, poe konfiguratsiooni ja seotud URL-e selle keskkonna jaoks, kus parajasti tegutsed.
{% endhint %}

***

## 1. samm — lõpeta kaupmehe liitumisprotsess

Enne integratsiooni alustamist veendu, et sinu kaupmehe liitumine SEB-ga on lõpule viidud.

#### Mida vajad

* Allkirjastatud kaupmeheleping
* Aktiveeritud kaupmehe portaali konto
* Juurdepääs testrežiimile
* Kaupmehelepingu kohaselt lubatud vajalikud teenused ja makseviisid

Kui sa ei ole veel liitumisprotsessi lõpetanud, vaata [**Kiirjuhend**.](/seb-docs-draft/seb-docs-public-et/alustamine/kiirstart.md)

***

## 2. samm — vali oma integratsioon

Vali integratsioonimeetod, mis sobib kõige paremini sinu e-kaubanduse platvormi, tehnilise arhitektuuri ja ärinõuetega.

Saadaolevad integratsioonivõimalused võivad hõlmata:

* [Ühtne kaupmehe API](/seb-docs-draft/seb-docs-public-et/integratsioon/kaupmehe-api.md)
* [API kliendi SDK](/seb-docs-draft/seb-docs-public-et/integratsioon/api-kliendi-sdk.md)
* [Majutatud kassalahendus](/seb-docs-draft/seb-docs-public-et/integratsioon/majutatud-kassavaade.md)
* [Veebipistikprogrammid](/seb-docs-draft/seb-docs-public-et/integratsioon/veebipluginad.md)
* [Mobiilsed SDK-d](/seb-docs-draft/seb-docs-public-et/integratsioon/mobiilne-sdk.md)

Vaata enne arenduse alustamist üle valitud integratsioonimeetodi nõuded ja võimalused.

{% hint style="info" %}
Sinu PCI DSS-i kohustused sõltuvad valitud integratsioonimeetodist ja sellest, kuidas sinu lahendus kaardiomaniku andmeid käsitleb.
{% endhint %}

***

## 3. samm — seadista testkeskkond

Pärast oma kaupmehe portaali konto aktiveerimist lähed vaikimisi [**testrežiimi**](/seb-docs-draft/seb-docs-public-et/juhendid/liivakast/liivakasti-reziimi-kasutamine.md) **vaikimisi**.

Enne arenduse alustamist:

* Kontrolli või loo oma testpood.
* Luba vajalikud makseviisid ja teenused.
* Hangi testpoe API mandaadid.
* Seadista **Avalehe URL**.
* Seadista **Tagasikutse URL**, vajaduse korral.
* Vaata üle sinu integratsioonile kohaldatav makse autoriseerimise ja makse kinnitamise konfiguratsioon.

Igal testpoel on oma API mandaadid. Kasuta alati mandaate, mis on seotud poodiga, mis töötleb sinu testtehinguid.

***

## 4. samm — arenda oma integratsioon

Rakenda valitud makselahendus vastava integratsioonidokumentatsiooni alusel.

Olenevalt integratsioonimeetodist võib rakendamine hõlmata:

* Autentimine
* Makse loomine
* Kliendi ümbersuunamise käsitlemine
* Makse olekute käsitlemine (vt Makseolekud [Kaardid](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/makse-olekud.md) ja [Pangamakse](/seb-docs-draft/seb-docs-public-et/makseviisid/pay-by-bank/makse-olekud.md))
* Tagasikutse / webhook'i töötlemine
* Vigade käsitlemine
* Tellimuse oleku haldamine
* Tagasimaksed ja muud makseoperatsioonid

***

## 5. samm — testi oma integratsiooni

Kinnita oma integratsioon [**testrežiimi**](/seb-docs-draft/seb-docs-public-et/juhendid/liivakast/liivakasti-reziimi-kasutamine.md) enne reaalsete klienditehingute töötlemist.

#### Põhilised maksesenaariumid

Kontrolli vajaduse korral:

* Õnnestunud maksed
* Tagasi lükatud või ebaõnnestunud maksed
* Kliendi tühistamised
* Katkestatud makseprotsessid
* Autentimisstsenaariumid
* Korduskatse pärast nurjumist

#### Integratsioon ja tellimuste käsitlemine

Veendu, et:

* Makseolekuid käsitletakse õigesti (vt Makseolekud [Kaardid](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/makse-olekud.md) ja [Pangamakse](/seb-docs-draft/seb-docs-public-et/makseviisid/pay-by-bank/makse-olekud.md)).
* Tagasikutse või webhook'i teavitused võetakse vastu ja töödeldakse.
* Kliendi ümbersuunamisi ja tagasipöördumisi käsitletakse õigesti.
* Duplikaatteavitusi ja -päringuid käsitletakse idempotentselt.
* Tellimused täidetakse alles pärast nõutud lõpliku makseoleku kinnitamist.
* Makse ID-d salvestatakse ja neid saab seostada tehingutega kaupmehe portaalis.

#### Makseoperatsioonid

Kui sinu konfiguratsioonis kohaldub, kontrolli:

* Tagasimakse
* Osaline tagasimakse
* Autoriseerimine ja makse kinnitamine
* Osaline makse kinnitamine
* Tühistamine või pöördmakse

#### Makseviisid

Kontrolli kõiki makseviise, mida kavatsete kasutada ja mis on lubatud sinu **testpoe**.

Kasuta [**Testandmed**](/seb-docs-draft/seb-docs-public-et/juhendid/liivakast/testandmed.md) ja [**Teststsenaariumid**](/seb-docs-draft/seb-docs-public-et/juhendid/liivakast/teststsenaariumid.md) soovitatud testkeskkonna valideerimisprotsessi jaoks.

{% hint style="info" %}
Sinu integratsiooni testimine ja valideerimine on sinu vastutusel. Ainult kliendi brauseri tagasipöördumist ei tohi kasutada kinnituseks, et makse on lõpule viidud. Kasuta kinnitatud lüüsi makseolekut tõeallikana.
{% endhint %}

***

## 6. samm — valmistu tootmiseks

Kui sinu integratsiooni on testitud ja oled valmis töötlema reaalsete klientide tehinguid:

1. Kinnita, et sinu kaupmehekonto jaoks on tootmisrežiim saadaval. Kui tootmisjuurdepääs pole veel lubatud, järgi kokkulepitud SEB aktiveerimisprotsessi ([*tootmiskäivituse kontrollnimekiri*](/seb-docs-draft/seb-docs-public-et/alustamine/kaivituse-kontrollnimekiri.md)).
2. Lülitu **tootmisrežiimi** Merchant Portalis.
3. Vaata üle või seadista oma tootmispood.
4. Hangi oma tootmispoe API mandaadid.
5. Seadista oma rakendus kasutama tootmiskeskkonna lõpp-punkte ja mandaate.
6. Kontrolli oma tootmiskeskkonda **Avalehe URL** ja **Tagasikutse URL**.
7. Veendu, et kõik nõutavad tootmiskeskkonna makseviisid ja teenused on aktiveeritud.
8. Vaata vajaduse korral üle oma majutatud kassalahenduse konfiguratsioon ja bränding.

{% hint style="info" %}
Ära kasuta tootmiskeskkonnas testkeskkonna mandaate ega lõpp-punkte. Tootmiskeskkonna konfiguratsiooni ja mandaate hallatakse testkeskkonnast eraldi.
{% endhint %}

***

## 7. samm — mine tootmisse

Kui sinu tootmiskonfiguratsioon on valmis, alusta reaalsete klientide tehingute töötlemist.

Jälgi oma esimesi tehinguid tähelepanelikult ja veendu, et:

* Maksed jõuavad oodatud lõppolekuteni (vt Makseolekud [Kaardid](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/makse-olekud.md) ja [Pangamakse](/seb-docs-draft/seb-docs-public-et/makseviisid/pay-by-bank/makse-olekud.md)).
* Tagasikutse / webhook'i teavitused võetakse vastu ja töödeldakse õigesti.
* Tellimused uuendatakse õigesti.
* Makse summad ja valuutad vastavad sinu tellimustele.
* Tehingud on nähtavad **kaupmehe portaalis → Tellimused**.
* Tagasimaksed ja muud nõutud makseoperatsioonid töötavad ootuspäraselt.
* Arveldamis- ja sobitamisprotsessid vastavad sinu ärikirjetele.

Teenuse pideva saadavuse jälgimiseks kasuta **SEB olekulehte** aadressil `status.ecommerce.sebgroup.com`.

### Kas vajad abi?

Kui koged ootamatut käitumist või vajad abi oma integratsiooniga:

* Vaata üle oma integratsiooni, makseviisi või funktsiooni kohta käiv asjakohane dokumentatsioon.
* Kasuta **AI assistenti** mis on saadaval dokumentatsiooniportaalis, et küsida dokumentatsiooni kohta ja leida asjakohast juhist.

<p align="center"><button type="button" class="button primary" data-action="ask" data-icon="gitbook-assistant">Esita küsimus…</button></p>

* Kui sa ei suuda probleemi dokumentatsiooni või AI assistendi abil lahendada, võta ühendust **SEB toega**.

SEB toega tehingu või tehnilise probleemi kohta ühendust võttes edasta asjakohane teave, näiteks **Makse ID**, ajatempel, mõjutatud teenus ja veateave, kui see on saadaval.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ecommerce.seb.ee/seb-docs-draft/seb-docs-public-et/alustamine/integratsiooninimekiri.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.