> 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/makseviisid/kaardid/makse-olekud.md).

# Makse olekud

Iga kaardimakse läbib kindla elutsükli. Makse olek – mitte kliendi brauser – on teie usaldusväärne allikas järgmiste sammude jaoks.

SEB e-kaubanduse maksevärav tagastab iga makse hetkeoleku kogu selle olelusringi vältel – API vastustes, tagasihelistamise teavituste kaudu ja Kaupmehe portaalis. Kasutage makse staatust tellimuste töötlemise juhtimiseks: see ütleb teile, millal täita, millal oodata ja millal lasta kliendil uuesti proovida.

{% hint style="info" %}
Tuginege alati tagasihelistamise teavitustele või maksevärava tagastatud makse staatusele. Ärge toetuge ainult sellele, et kliendi brauser naaseb teie veebisaidile – brauser ei pruugi kunagi naasta isegi siis, kui makse õnnestub, ning võib naasta enne, kui lõplik staatus on teada.
{% endhint %}

See leht kirjeldab kaardimaksete staatuse olelusringi, sealhulgas kaardivõrkude kaudu töödeldud digitaalse rahakoti makseid (Apple Pay, Google Pay, Click to Pay). Pangaülekandega maksed kasutavad lihtsustatud kontolt kontole olelusringi – vt [Pay by Bank › Makseolekud](/seb-docs-draft/seb-docs-public-et/makseviisid/pay-by-bank/makse-olekud.md).

### Staatuse olelusring

Kaardimakse liigub läbi järgmiste etappide:

*Algatatud → Autoriseeritud → Kasseeritud → Arveldatud ( → Tagastatud )*

*Ebaõnnestunud, tühistatud ja hüljatud on lõplikud olekud, mis võivad olelusringi lõpetada enne selle lõpuleviimist.*

See, millise tee makse läbib, sõltub töötlemismudelist: ostu (üheastmelise) makse liigub Algatatud olekust otse Kasseeritud olekusse, samal ajal kui autoriseerimise + kasseerimise (kahest etapist koosnev) makse liigub esmalt läbi Autoriseeritud oleku. Töötlemismudelite kohta vt jaotist Toetatud toimingud.

### Staatused

<table><thead><tr><th width="113.33331298828125" valign="top">Olek</th><th width="261.66668701171875" valign="top">Kirjeldus</th><th width="91.3333740234375" valign="top">Lõplik?</th><th valign="top">Soovitatav kaupmehe tegevus</th></tr></thead><tbody><tr><td valign="top">Algatatud</td><td valign="top">Loodud on uus makse, kuid ühtegi makseviisi pole veel lõpetatud – klient valib makseviisi või viib lõpule maksmise ja autentimise.</td><td valign="top">Ei</td><td valign="top">Hoidke tellimus ootel. Oodake järgmist staatuse teatist. Ärge täitke tellimust.</td></tr><tr><td valign="top">Autoriseeritud</td><td valign="top">Makse summa on kliendi kontol reserveeritud (eelautoriseerimine). Makse lõpuleviimiseks tuleb see lõpliku summa kasseerimisega lõplikult vormistada.</td><td valign="top">Ei</td><td valign="top">Reserveerige kaup. Kasseerige siis, kui olete valmis vahendeid vastu võtma – või pöörake tehing tagasi, kui tellimus tühistatakse.</td></tr><tr><td valign="top">Kasseeritud</td><td valign="top">Klient on maksnud ja vahendid on kasseeritud, kuid neid ei ole veel teie kontole üle kantud. Kaardimaksete puhul on see „tasutud“ staatus.</td><td valign="top">Ei</td><td valign="top">Jätkake tellimuse täitmisega. Salvestage makseviide lepitamise jaoks.</td></tr><tr><td valign="top">Arveldatud</td><td valign="top">Lõplik staatus: makse on täielikult lõpule viidud ja vahendid on kantud teie kontole.</td><td valign="top">Jah</td><td valign="top">Mingeid toiminguid pole vaja – kasutage finantslepituseks.</td></tr><tr><td valign="top">Ebaõnnestunud</td><td valign="top">Lõplik staatus: makse ei saanud tehniliste probleemide, väljastaja keeldumise või muude vigade tõttu lõpule viidud.</td><td valign="top">Jah</td><td valign="top">Teavitage klienti selge sõnumiga ja võimaldage uut maksekatset või teist makseviisi.</td></tr><tr><td valign="top">Tühistatud</td><td valign="top">Lõplik staatus: makse tühistati enne arveldamist – kliendi, teie poolt või autoriseerimise tagasipööramise kaudu.</td><td valign="top">Jah</td><td valign="top">Suunake klient tagasi kassasse või sulgege tellimus. Vabastage kõik reserveeritud kaubavarud.</td></tr><tr><td valign="top">Hüljatud</td><td valign="top">Lõplik staatus: makse algatati, kuid ühtegi makseviisi ei lõpetatud – klient ei valinud makseviisi või lahkus protsessist enne lõpetamist.</td><td valign="top">Jah</td><td valign="top">Käsitlege seda kui tasumata. Kui klient soovib jätkata, looge uus makse – ärge kasutage sama makset uuesti.</td></tr><tr><td valign="top">Tagastatud</td><td valign="top">Makse tagastati osaliselt või täielikult pärast selle edukat lõpuleviimist.</td><td valign="top">–</td><td valign="top">Värskendage tellimust ja tagasimakse staatust vastavalt sellele.</td></tr></tbody></table>

### Millal on kaardimakse „tasutud“?

Kaardimaksete puhul loetakse tehing üldjuhul tasutuks kohe, kui see jõuab Kasseeritud staatuse juurde – see on hetk, mil tellimus tuleb täita. Arveldatud staatus tuleb hiljem, kui arveldus omandaja pangaga on lõpule viidud, ja seda võib rakendada pärast seadistatavat ajaperioodi (näiteks üks päev). Arveldatud kinnitab, et vahendid on teie kontole kantud; kasutage seda finantslepituseks, mitte täitmise käivitajana.

Märkus: see on peamine erinevus pangaülekandega maksete suhtes: kontolt kontole maksed ei kasuta üldse Autoriseeritud ega Kasseeritud staatuseid ning neid peetakse tasutuks alles Arveldatud olekus. Kui te aktsepteerite mõlemat, veenduge, et teie tellimusloogika tugineks iga makseviisi puhul õigele staatusele.

### Kuidas toimingud muudavad staatust

<table><thead><tr><th valign="top">Toiming</th><th valign="top">Tulemuseks olev staatus</th></tr></thead><tbody><tr><td valign="top">Ost (autoriseerimine + kasseerimine ühes etapis)</td><td valign="top">Kasseeritud</td></tr><tr><td valign="top">Autoriseerimine (eelautoriseerimine)</td><td valign="top">Autoriseeritud</td></tr><tr><td valign="top">Kasseerimine / osaline kasseerimine autoriseeritud makse puhul</td><td valign="top">Kasseeritud</td></tr><tr><td valign="top">Autoriseerimise tagasipööramine (tühistamine)</td><td valign="top">Tühistatud</td></tr><tr><td valign="top">Tagasimakse / osaline tagasimakse kasseeritud või arveldatud makse puhul</td><td valign="top">Tagastatud (allpool kirjeldatud tagasimakse olelusringi kaudu)</td></tr><tr><td valign="top">Arveldus omandaja pangaga (automaatne)</td><td valign="top">Arveldatud</td></tr></tbody></table>

&#x20;Vt [Toetatud toimingud](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/toetatavad-toimingud.md) selle kohta, millal iga toimingut kasutada.

### Tagasimakse olelusring

Tagasimakse töötlemine järgib eraldi olelusringi koos oma olekutega – näiteks Töötlemisel, Lõpetatud ja Tagasipööratud:

* Kui tagasimakse jõuab olekusse Lõpetatud, värskendatakse vastava makse staatuseks Tagastatud – nii täieliku kui ka osalise tagasimakse puhul.
* Kui tagasimakse hiljem tühistatakse või tagasi pööratakse, võib makse staatus naasta Arveldatud olekusse, eeldusel et sellele maksele ei ole järel muid lõpetatud tagasimakseid.

Jälgige oma tellimuste halduses tagasimakse staatuseid makse staatustest eraldi – makse, mille olek on Tagastatud, võib tähendada osalist tagasimakset, millel on veel tagastatav jääk.

### Aegumised, kehtivusaja lõppemine ja hüljatud maksed

Maksed, mida ei lõpetata määratud ajaraamides, aeguvad automaatselt või märgitakse hüljatuks – maksevärav ei jäta makseid määramata ajaks ootele. Aegumise ja kehtivusaja lõppemise käitumine võib makseviisist ja tehingu olekust sõltuvalt erineda.

Poolikud ja erandlikud maksekatsed on API-s ja Kaupmehe portaalis selgelt tuvastatavad spetsiaalsete staatuse näitajate kaudu, toetades uurimist, lepitamist ja operatiivset järeltegevust. Kui makse püsib Algatatud olekus oodatust kauem, uurige enne tegevuse võtmist asjaolusid – ja oodake alati lõplikku staatuse teatist enne tellimuse uuendamist.

### Kaupmehe parimad tavad

* Täida tellimused Kasseeritud oleku korral (kaardimaksed), kinnitatuna tagasihelistamise teavituse või maksevärava tagastatud makse staatuse kaudu.
* Pärast tagasihelistamise teavituse saamist küsige enne tellimuse uuendamist täielikud makseandmed – teatis ütleb teile, et staatus muutus; makseinfo ütleb teile, milleks see muutus.
* Veenduge, et teie staatuse käsitlus oleks idempotentne – korduvad teavitused ei tohi tekitada topelt täitmisi ega tagasimakseid.
* Hoidke tellimused ootel, kuni makse on Algatatud või Autoriseeritud olekus, ja käsitlege kõiki lõplikke staatuseid (Ebaõnnestunud, Tühistatud, Hüljatud) selge kliendisõnumi ja uuesti proovimise teega.
* Salvestage makseviited lepitamiseks ja klienditoe jaoks ning lepitake Arveldatud makseid oma konto väljavõtetega.

### Seotud dokumentatsioon

* [Toetatud toimingud](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/toetatavad-toimingud.md)
* [Kaardimakse olelusring](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/kaardimakse-elutsukkel.md)
* [Tagasihelistamise teavitused](/seb-docs-draft/seb-docs-public-et/integratsioon/kaupmehe-api/webhookid.md)
* [Tagasimaksed](/seb-docs-draft/seb-docs-public-et/omadused/tagasimaksed.md)
* [Pay by Bank › Makseolekud](/seb-docs-draft/seb-docs-public-et/makseviisid/pay-by-bank/makse-olekud.md)
* [Kaupmehe API](/seb-docs-draft/seb-docs-public-et/integratsioon/kaupmehe-api.md)


---

# 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/makseviisid/kaardid/makse-olekud.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.