> 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/tirgotaja-api/atbilzu-apstrade.md).

# Atbilžu apstrāde

Apstrādājot API atbildes, ir svarīgi nošķirt:

* **HTTP statusa kodus** – Norāda, vai pieprasījums tika veiksmīgi apstrādāts no tehniskā viedokļa.
* **Kļūdu kodus** – Sniedz papildu informāciju, ja pieprasījumu nevar veiksmīgi apstrādāt.
* **Maksājuma statusus un statusa iemeslus** – Norāda maksājuma operācijas biznesa rezultātu.

### HTTP statusa kodus

HTTP statusa kodi norāda paša API pieprasījuma iznākumu.

| Statusa diapazons | Apraksts                                                                                                                                                                             |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `2xx`             | Pieprasījums tika veiksmīgi saņemts un apstrādāts.                                                                                                                                   |
| `4xx`             | Pieprasījumu nevarēja apstrādāt pieprasījuma problēmas dēļ, piemēram, validācijas kļūdu, autentifikācijas neveiksmes, nepietiekamu tiesību vai pieprasījumu ātruma ierobežojumu dēļ. |
| `5xx`             | Pieprasījumu nevarēja pabeigt iekšējas sistēmas kļūdas vai īslaicīgas pakalpojuma nepieejamības dēļ.                                                                                 |

Veiksmīga `2xx` atbilde tikai norāda, ka pieprasījums tika apstrādāts veiksmīgi. Tā **ne** nenozīmē, ka pats maksājums bija veiksmīgs; tam tiek izmantoti maksājuma statusi.

#### Kļūdu kodus

Neveiksmīgu pieprasījumu gadījumā atbilde satur vienu vai vairākus kļūdu kodus, kas apraksta konkrēto neveiksmes iemeslu.

Tipiski piemēri ir:

* Nederīgi vai trūkstoši pieprasījuma parametri.
* Autentifikācijas vai autorizācijas kļūmes.
* Pieprasījumu limita pārkāpumi.
* Citas biznesa vai tehniskās validācijas kļūdas.

Kļūdu kodi jāizmanto kopā ar HTTP statusa kodu, ieviešot kļūdu apstrādes un problēmu novēršanas loģiku.

### Maksājuma statusi

Ar maksājumiem saistītām operācijām maksājuma iznākums tiek paziņots, izmantojot **maksājuma statuss** API atbildē atgriezto vai ar atpakaļsaukuma paziņojumiem piegādāto.

Veiksmīga HTTP atbilde var norādīt uz maksājumu, kas ir **gaidāms**, **veiksmīgs**, vai **neizdevies**, atkarībā no maksājuma apstrādes iznākuma. Tāpēc lietotnēm maksājuma iznākuma noteikšanai jāizmanto maksājuma statuss kā autoritatīvs avots.

#### Maksājuma statusa iemesli

Maksājuma statusiem var būt pievienots **statusa iemesls** kas sniedz papildu kontekstu par to, kāpēc maksājums nonācis pašreizējā stāvoklī.

Statusa iemesli norāda:

* Biznesa līmeņa rezultātus, piemēram, nepietiekamus līdzekļus, beigušos kartes derīguma termiņu, aizdomas par krāpšanu, emitenta atteikumu vai tīkla atteikumu.
* Apstrādes un saziņas problēmas, piemēram, emitenta nepieejamību, tīkla pārtraukumus vai īslaicīgas apstrādes kļūmes.

Statusa iemesli ir paredzēti, lai atbalstītu maksājumu apstrādes loģiku, problēmu novēršanu, atskaišu veidošanu un, kur nepieciešams, saziņu ar klientiem.


---

# 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/tirgotaja-api/atbilzu-apstrade.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.