> 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/veebipluginad/opencart/tellimuse-elutsukkel-ja-toimingud.md).

# Tellimuse elutsükkel ja toimingud

Kuidas SEB e-kaubanduse makselüüsi OpenCarti laiendus käsitleb tellimusi, tellimuse olekuid ja igapäevaseid toiminguid

## Kuidas tellimuse staatused muutuvad

Pärast makset uuendab tellimust kaks teed: klient naaseb teie poodi ja autoriteetne serverilt serverile **callback-teavitus**. Kumbki tee ei usalda saadud teadet — mõlemad kontrollivad enne muudatuste tegemist maksevärava kaudu üle tegeliku makse staatuse ([kuidas seda kontrollitakse](/seb-docs-draft/seb-docs-public-et/integratsioon/veebipluginad/opencart/konfigureerimine.md#how-callback-notifications-are-verified)). Iga muudatus kuvatakse tellimuse ajaloos koos kommentaariga.

| Makse staatus makseväravas                  | OpenCarti tellimuse staatus                     | Mida see tähendab                                                                                             |
| ------------------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Makseleht avatud, kuid makset ei lõpetatud  | **Ootel** ("Makse algatatud")                   | Ootab kliendi makset                                                                                          |
| Saatmiseks töötlemisse / autoriseeritud     | **Ootel** + ootel/eelautoriseerimise kommentaar | Raha on broneeritud või teel, kuid pole lõplik. Kui see on eelautoriseeritud, kinnitage see Merchant Portalis |
| Kinnitatud / arveldatud                     | **Töötlemisel** ("Makse lõpule viidud")         | Makstud — täitke tavapäraselt                                                                                 |
| Tühistatud / pooleli jäetud / ebaõnnestunud | **Tühistatud** (põhjuse kommentaariga)          | Klient suunatakse tagasi kassasse, et proovida uuesti                                                         |

Märkused kaupmeestele:

* Kaardistus kasutab OpenCarti vaikestaatusi. Kui teie poes on nende numbrid muudetud või need on eemaldatud, võtke enne kasutuselevõttu ühendust SEB toega ([Konfiguratsioon](/seb-docs-draft/seb-docs-public-et/integratsioon/veebipluginad/opencart/konfigureerimine.md)).
* Tellimus, mis on jäänud olekusse *Ootel* ja mille puhul klient kinnitab, et makse õnnestus: kontrollige kõigepealt Merchant Portali (<https://merchantportal.ecommerce.sebgroup.com>), seejärel callbacki registreeringut.

![Makstud SEB E-commerce Payment Gateway tellimus vaates Müük → Tellimused → Vaata, mille staatus on Töötlemisel ning mille tellimuse ajaloo kommentaarid näitavad makse kulgu olekust Ootel kuni Töötlemisel.](https://4089891531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuBDtfypkI85zidcVwaDj%2Fuploads%2Fx9TjRqeTq7I0XDKBtSxM%2Foc-order-detail-pending-processing.png?alt=media)

## Mida ja kus teha

| Ülesanne                             | Kus                                                                                                                                                                                                                                                                                               |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Vaata makse staatust tellimuse kaupa | **Müük → Tellimused → Vaata** (tellimuse ajaloo kommentaarid). Maksevärava makse-ID salvestatakse tellimusele, kuid OpenCarti vaikimisi tellimusevaade ei kuva seda kunagi — kontrollige `egw_checkout.log` (**Süsteem → Hooldus → Vealogid**) kui peate tellimuse Merchant Portaliga kokku viima |
| Kinnitage eelautoriseeritud makse    | Merchant Portal                                                                                                                                                                                                                                                                                   |
| Tehke tagasimakse                    | Merchant Portal — adminpaneelis puudub selle makseviisi jaoks tagasimakse toiming; tellimuse staatus uuendatakse automaatselt, kui maksevärav kinnitab tagasimakse                                                                                                                                |
| Rekonsileerimine                     | Merchant Portal; sobitage makse-ID alusel                                                                                                                                                                                                                                                         |

## Erandjuhtumid

* **Callback ei saabu kunagi:** tellimused jäävad seisma, kuigi makse edeneb. Parandage callbacki registreering ([Konfiguratsioon](/seb-docs-draft/seb-docs-public-et/integratsioon/veebipluginad/opencart/konfigureerimine.md)); ajastatud korduskontrolli ei ole.
* **Korduvad teavitused** tuvastatakse ja ignoreeritakse ohutult.
* **Klient maksab, kuid ei naase kunagi:** callback lõpetab tellimuse siiski.
* **Klient logitakse välja ja talle kuvatakse pärast maksmist viga:** **Seansi SameSite-küpsis** on endiselt *Strict*. Määrake see väärtusele *Lax* ([Installimine](/seb-docs-draft/seb-docs-public-et/integratsioon/veebipluginad/opencart/installimine.md)). Seni naaseb klient välja logituna ja näeb *Midagi läks valesti. Palun proovige uuesti.* kuigi makse õnnestus, ja võib tasuda teist korda. Tellimust ja kõiki kaarte, mille klient valis salvestada, uuendatakse alles callbacki saabumisel. Kontrollige **Müük → Tellimused** ja Merchant Portali enne, kui palute kliendil uuesti proovida.
* **Salvestatud kaarti ei aktsepteerita enam** maksevärava poolt: klient näeb *Seda salvestatud kaarti ei saa kasutada. Palun makske uue kaardiga.*, tellimus tühistatakse nagu iga ebaõnnestunud makse puhul ning kaart eemaldatakse nende salvestatud kaartide hulgast. Vt [Salvestatud kaardid](/seb-docs-draft/seb-docs-public-et/integratsioon/veebipluginad/opencart/konfigureerimine.md#saved-cards).

## Arendajatele

Callbacki lõpp-punkt: `POST https://your-store.example/index.php?route=extension/egw_checkout/callback`, JSON `{type, paymentId, merchantReference, paymentStatus}`; `merchantReference` on OpenCarti tellimuse ID. Käitleja nõuab, et tellimuse salvestatud tehingu ID vastaks `paymentId` ja hangib enne muudatuste tegemist uuesti reaalajas staatuse; päring ise ei ole allkirjastatud (vt [Kuidas callback-teavitusi kontrollitakse](/seb-docs-draft/seb-docs-public-et/integratsioon/veebipluginad/opencart/konfigureerimine.md#how-callback-notifications-are-verified)). Tagastustee: `extension/egw_checkout/redirect` (tokeniga kaitstud ristseansi kasutuse vastu). Logi: `system/storage/logs/egw_checkout.log`, samuti nähtav all **Süsteem → Hooldus → Vealogid**.


---

# 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/veebipluginad/opencart/tellimuse-elutsukkel-ja-toimingud.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.
