> 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/api-kliendi-sdk/ulevaade.md).

# Ülevaade

Tutvuge toetatud SDK-keelte, API ulatuse, juurdepääsunõuete, võimekuste ja alfa-toega.

See **API kliendi SDK** on serveripoolsete teekide kogum integreerumiseks **Kaupmehe API**.

SDK töötab täielikult teie taustasüsteemis ja pakub tugevalt tüpiseeritud, keelespetsiifilisi kliente, mis kapseldavad:

* HTTP-side
* OAuth 2.0 kliendi autentimine
* JWE kaardiandmete krüptimine
* JSONi serialiseerimine ja deserialiseerimine
* Webhook-teavituste töötlemine

Selle asemel, et töötada otse toorete REST-päringutega, suhtlevad arendajad tugevalt tüpiseeritud päringu- ja vastusemudelitega.

***

## Teie kohustused

SDK lihtsustab suhtlust Merchant API-ga, kuid teie rakendus jääb vastutavaks järgmise eest:

* Taustarakenduse majutamine.
* Kliendi ümbersuunamiste ja tagasipöördumislehtede haldamine.
* API volituste kaitsmine.
* Avalikult ligipääsetava HTTPS-lõpp-punkti pakkumine veebikonksu teavituste jaoks.
* Teie tellimuse elutsükli ja äriloogika haldamine.

{% hint style="info" %}
SDK on mõeldud ainult serveripoolsetele rakendustele. Seda ei tohi kasutada otse brauseripõhistest või mobiiliklientide rakendustest, kuna see nõuab API volituste turvalist käsitlemist.

SDK ei renderda kliendile mõeldud kassalehti.

Hosted Checkouti või brauseripõhiste integratsioonide kohta vaata **Hostitud Checkout** dokumentatsiooni.
{% endhint %}

***

## Toetatud keeled

SDK on hetkel saadaval järgmistele:

| Keel                 | Põhilised sõltuvused                                                   |
| -------------------- | ---------------------------------------------------------------------- |
| Java                 | Jackson, Nimbus JOSE+JWT, SLF4J API                                    |
| PHP                  | Guzzle 7, web-token/jwt-library 3, ReactPHP HTTP (veebikonksu kuulaja) |
| C# / .NET            | jose-jwt, System.Text.Json                                             |
| Node.js / TypeScript | axios, jose                                                            |

{% hint style="info" %}
Kõik keele-implementatsioonid pakuvad sama funktsionaalset API-katvust.
{% endhint %}

***

## API katvus

SDK pakub täielikku katvust **Merchant API v1**, sh:

* Maksete algatamine (CIT ja MIT)
* Makseinfo
* Makse kinnitamised
* Tühistamised
* Tagasimaksed
* Tagasimaksete tühistamised
* Hosted Checkout sessioonid
* Pay by Bank
* Click to Pay
* Tokenite haldamine
* EMV® 3-D Secure
* Poe teave
* Webhook-teavitused

Praegu pole ühtegi Merchant API toimingut, mida ei toetata.

***

## Toetatud keskkonnad

SDK toetab nii Sandboxi kui ka Productioni keskkondi.

| Keskkond   | Eesmärk                                               |
| ---------- | ----------------------------------------------------- |
| Liivakast  | Arendamine, testimine ja integratsiooni valideerimine |
| Production | Reaalajas maksete töötlemine                          |

Keskkonna valik tehakse sobiva API baas-URL-i konfigureerimisega.

***

## SDK võimalused

SDK pakub sisseehitatud tuge järgmisele:

* OAuth 2.0 kliendimandaatidega autentimine
* Automaatne juurdepääsutokenite vahemällu salvestamine ja uuendamine
* JWE kaardiandmete krüptimine
* Tugevalt tüpiseeritud päringu- ja vastusemudelid
* Veebikonksu teavituste käsitlemine
* Ühtlane veahaldus
* Vahetatavad HTTP-kliendi, serialiseerija, krüptimise ja logimise implementatsioonid

{% hint style="info" %}
Täiendavad rakendusdetailid on kirjeldatud **Juhendites** jaotis.
{% endhint %}

***

## Versioonihaldus ja tugi

SDK järgib **MAJOR.MINOR.PATCH** semantilist versioonimist.

Kõik sama SDK väljalaske keele-implementatsioonid jagavad sama versiooninumbrit.

SDK sihib **Merchant API v1**. API versiooni valik ei ole seadistatav.

## Levitamine

Iga keele SDK tarnitakse kontrollsummaga verifitseeritud ZIP-arhiivina, mitte paketiregistri väljalaskena. Vaata [Levitamine](/seb-docs-draft/seb-docs-public-et/integratsioon/api-kliendi-sdk/ulevaade/jaotus.md) verifitseerimisetappe ja keelepõhiseid installimislinke.


---

# 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/api-kliendi-sdk/ulevaade.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.