> 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-lv/integracija/api-klienta-sdk/parskats.md).

# Pārskats

Uzziniet par atbalstītajām SDK valodām, API pārklājumu, piekļuves prasībām, iespējām un alfa atbalstu.

Šis **API klienta SDK** ir servera puses bibliotēku kopums integrācijai ar **Tirgotāja API**.

SDK darbojas pilnībā jūsu aizmugursistēmā un nodrošina stingri tipizētus, konkrētai valodai pielāgotus klientus, kas aptver:

* HTTP saziņu
* OAuth 2.0 klienta autentifikāciju
* JWE kartes datu šifrēšanu
* JSON serializāciju un deserializāciju
* Webhook paziņojumu apstrādi

Tā vietā, lai tieši strādātu ar neapstrādātiem REST pieprasījumiem, izstrādātāji mijiedarbojas ar stingri tipizētiem pieprasījumu un atbilžu modeļiem.

***

## Jūsu pienākumi

SDK atvieglo saziņu ar Tirgotāja API, taču jūsu lietotne joprojām ir atbildīga par:

* Jūsu aizmugursistēmas lietotnes mitināšanu.
* Klientu pāradresāciju un atgriešanās lapu pārvaldību.
* API akreditācijas datu aizsardzību.
* Publiski pieejama HTTPS galapunkta nodrošināšanu webhook paziņojumiem.
* Jūsu pasūtījumu dzīves cikla un biznesa loģikas pārvaldību.

{% hint style="info" %}
SDK ir paredzēts tikai servera puses lietotnēm. To nedrīkst izmantot tieši pārlūkprogrammas vai mobilajās klienta lietotnēs, jo tam nepieciešama droša API akreditācijas datu apstrāde.

SDK nerenderē klientam redzamās norēķinu lapas.

Hostētam norēķinu procesam vai pārlūkprogrammas integrācijām skatiet **Hosted Checkout** dokumentāciju.
{% endhint %}

***

## Atbalstītās valodas

SDK šobrīd ir pieejams šādām valodām:

| Valoda               | Galvenās atkarības                                                    |
| -------------------- | --------------------------------------------------------------------- |
| Java                 | Jackson, Nimbus JOSE+JWT, SLF4J API                                   |
| PHP                  | Guzzle 7, web-token/jwt-library 3, ReactPHP HTTP (Webhook klausītājs) |
| C# / .NET            | jose-jwt, System.Text.Json                                            |
| Node.js / TypeScript | axios, jose                                                           |

{% hint style="info" %}
Visas valodu implementācijas nodrošina vienādu funkcionālo API pārklājumu.
{% endhint %}

***

## API pārklājums

SDK nodrošina pilnīgu **Tirgotāja API v1** pārklājumu, tostarp:

* Maksājuma uzsākšana (CIT un MIT)
* Maksājuma informācija
* Ieturējumi
* Atcelšanas
* Atmaksas
* Atmaksu reversēšana
* Hostētā Checkout sesijas
* Maksājums ar banku
* Click to Pay
* Tokenu pārvaldība
* EMV® 3-D Secure
* Veikala informācija
* Webhook paziņojumi

Pašlaik nav neatbalstītu Tirgotāja API darbību.

***

## Atbalstītās vides

SDK atbalsta gan Sandbox, gan Production vides.

| Vide       | Mērķis                                         |
| ---------- | ---------------------------------------------- |
| Smilškaste | Izstrāde, testēšana un integrācijas validācija |
| Produkcija | Tieša maksājumu apstrāde                       |

Vides izvēle tiek veikta, konfigurējot atbilstošo API bāzes URL.

***

## SDK iespējas

SDK nodrošina iebūvētu atbalstu šādām funkcijām:

* OAuth 2.0 klienta akreditācijas datu autentifikācija
* Automātiska piekļuves marķieru kešošana un atjaunošana
* JWE kartes datu šifrēšanu
* Stingri tipizēti pieprasījumu un atbilžu modeļi
* Webhook paziņojumu apstrāde
* Vienota kļūdu apstrāde
* Nomaināmas HTTP klienta, serializatora, šifrēšanas un žurnalēšanas implementācijas

{% hint style="info" %}
Papildu ieviešanas detaļas ir aprakstītas sadaļā **Ceļveži** sadaļu.
{% endhint %}

***

## Versiju veidošana un atbalsts

SDK ievēro **MAJOR.MINOR.PATCH** semantisko versēšanu.

Visām vienas un tās pašas SDK versijas valodu implementācijām ir vienāds versijas numurs.

SDK ir paredzēts **Tirgotāja API v1**. API versijas izvēle nav konfigurējama.

## Izplatīšana

Katras valodas SDK tiek piegādāts kā ar kontrolsummu pārbaudīts ZIP arhīvs, nevis pakotņu reģistra izlaidums. Skatiet [Izplatīšana](/seb-docs-draft/seb-docs-public-lv/integracija/api-klienta-sdk/parskats/izplatisana.md) verifikācijas soļiem un katras valodas instalēšanas saitēm.


---

# 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-lv/integracija/api-klienta-sdk/parskats.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.