> 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/integratsioon/kaupmehe-api.md).

# Kaupmehe API

See **Kaupmehe API** koosneb REST API-dest, mis toetavad maksete algatamist, maksete elutsükli haldamist ja kassafunktsionaalsust. Nende API-de abil saate luua ja hallata makseid, kinnistada autoriseeritud tehinguid, töödelda tagasimakseid ning saada tagasikutse teateid makse- ja tokeni elutsükli sündmuste kohta.

A **otse API-integratsioon** pakub suurimat paindlikkust ja kohandatavust. Enne otse API-integratsiooni loomist hinnake siiski saadaolevaid **SDK-d** ja **veebipluginad**, mis võivad lihtsustada juurutamist, vähendades arendustegevuse mahtu ja kiirendades turule jõudmist.

### Saadaolevad API-d

Kaupleja API on jaotatud järgmisteks API-deks:

* **Maksed** – Hallake makse elutsüklit, sh makse algatamist, kinnistamist, tühistamist ja makse oleku päringut.
* **Kassaseansid** – Toetavad makseviisi valikut, makseandmete kogumist ja kliendi toiminguid, mis on vajalikud makse autoriseerimiseks, näiteks 3-D Secure'i autentimist.
* **Tagasimaksed** – Algatage ja jälgige täielikke või osalisi tagasimakseid varem töödeldud maksete eest.
* **Makselüüsi tokenid** – Tõmmake välja ja hallake salvestatud maksetokeneid, võimaldades korduvaid makseid ja ühe klõpsuga kassakogemusi.
* **Kauplused** – Tõmmake välja poe konfiguratsioon ja kaupmehe teave ning tehke maksetega seotud seadistustoiminguid, näiteks Apple Pay veebiseansside algatamist.
* **Tagasihelistamise teavitused** – Saage asünkroonseid teateid makse- ja tokeni elutsükli sündmuste kohta, võimaldades teie süsteemidel püsida sünkroonis makse oleku muudatuste ja salvestatud maksetokenite uuendustega.

Lõpp-punktide spetsifikatsioonide, skeemide ja väljade kirjelduste kohta vt [**Kaupleja API viide**](/seb-docs-draft/seb-docs-public-et/api-viide/kaupmehe-api.md).

### Integratsioonimudelid

Integratsioonimudelid määratlevad, kuidas maksevoog on jaotatud teie süsteemi ja **SEB e-kaubanduse makselüüs**.

* **Täielik API-integratsioon** - Võimaldab teil hallata kogu maksekogemust, sealhulgas kassat, makseandmete kogumist ja maksete elutsükli toiminguid Kaupleja API kaudu.
* **Hübriidintegratsioon** - Makse elutsükli toimingud, nagu makse algatamine, kinnistamine, tühistamine ja tagasimaksed, tehakse API või SDK kaudu, samal ajal kui kassakogemus ja tundlike makseandmete kogumine toimub makselüüsi hostitud kassalehe kaudu.

Hübriidintegratsioonimudel on kõige levinum lähenemisviis, kuna see ühendab API-põhise maksete halduse paindlikkuse majutatud kassalahenduse lihtsuse, turvalisuse ja väiksema vastavusulatusega.


---

# 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/integratsioon/kaupmehe-api.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.
