> 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/kaupmehe-api/webhookid.md).

# Webhookid

Serverilt serverile teavitused, mis annavad teie süsteemidele teada, kui makse olek või makselüüsi token muutub – usaldusväärne alternatiiv kliendi brauseri ootamisele.

Iga kord, kui makse muudab olekut – see tasutakse, ebaõnnestub, tühistatakse, aegub või tagastatakse – saadab makselüüs **Veebikonksu (nimetatakse ka tagasikutse teavitusteks)** konfigureeritud Callback URL-ile. Seejärel saavad teie süsteemid tellimust automaatselt uuendada, ilma et keegi peaks Kaupleja portaalil silma peal hoidma või sõltuma sellest, et kliendi brauser naaseb teie veebisaidile.

Veebikonksud edastatakse serverist serverisse, sõltumata sellest, mida klient teeb. Need jõuavad kohale isegi siis, kui klient sulgeb pärast maksmist brauseri, kaotab ühenduse või ei naase kunagi teie poodi. Täitke tellimused makselüüsi kaudu kinnitatud makseoleku põhjal, mitte kliendi tagasipöördumise põhjal.

Veebikonksud on soovitatavad iga integratsioonitüübi puhul – Kaupleja API, Hostitud kassaleht, veebipluginid ja makselingid. Veebipluginid töötlevad veebikonksusid oma standardse funktsionaalsuse osana. Oma integratsioonide jaoks rakendage veebikonksu lõpp-punkt.

### Kuidas see toimib

1. Seadistage oma Callback URL. Kaupleja portaalis määrake oma HTTPS-lõpp-punkt, mis võtab poe kohta teavitusi vastu.
2. Makse muudab olekut. Klient tasub, jätab makse pooleli, capture lõpetatakse, tagasimakse töödeldakse – iga olekumuutus käivitab teavituse.
3. Makselüüs teavitab teie lõpp-punkti. Teavitus ütleb teile, milline makse muutus (Makse ID) ja milline on selle viimane olek. Teie lõpp-punkt kinnitab vastuvõtu eduka vastusega.
4. Te hangite makse üksikasjad. Pärast teavituse saamist kutsuge esile Get Payment Information API, et saada täielikud ja ajakohased makseandmed – teavitus on päästik; API vastus on autoriteetne allikas.
5. Te uuendate oma tellimust. Kinnitatud oleku põhjal uuendage tellimust: täitke see tasutud oleku korral, vabastage laoseis lõpliku ebaõnnestumise korral, registreerige tagasimakse ja nii edasi. Soovitatava tegevuse iga oleku kohta leiate jaotisest Payment Statuses.

{% hint style="info" %}
Kohtle teavitust signaalina, mitte andmetena. Enne tellimuse uuendamist laadige makse üksikasjad alati autentitud API kaudu – see annab teile nii täieliku hetkeoleku kui ka kaitseb teid võltsitud või aegunud teavituste eest.
{% endhint %}

{% hint style="warning" %}
Ärge küsige Get Payment Informationi iga algatatud makse puhul. Kasutage veebikonksusid tavapärase päästikuna oleku väljalugemiseks. Pärige API-st ainult erandjuhtudel, näiteks kui teavitus ei saabu oodatud aja jooksul või kui operaator küsib käsitsi ajakohaseid makseandmeid.
{% endhint %}

### Mis käivitab teavituse

* Makse olekumuutused. Iga makse oleku muutus – nii kaardimaksete kui ka Pay by Banki puhul. See hõlmab ka tagasimaksega seotud muudatusi: kui tagasimakse lõpetatakse, muutub makse olekuks Tagastatud ja teavitus saadetakse.
* Tõendi muudatused. Kui tokeniseerimine on lubatud, teavitab makselüüs teid tokenite muudatustest – näiteks siis, kui salvestatud token peatatakse või deaktiveeritakse – et saaksite hoida salvestatud maksemeetodid ajakohasena ja peatada kaupleja algatatud tasud. Vt Tokenization.

### Oma veebikonksu lõpp-punkti kujundamine

* Kasutage HTTPS-i. Veebikonksud edastatakse ainult turvalistele lõpp-punktidele. Piirake lõpp-punkt veebikonksude töötlemiseks.
* Vastake kiiresti. Kinnitage teavitus kohe ja töödelge see võimaluse korral asünkroonselt. Pikaajaline äriloogika päringukäsitleja sees põhjustab ajalõppe ja tarbetuid korduskatseid.
* Tehke see idempotentseks. Sama teavitus võidakse edastada rohkem kui üks kord – näiteks korduskatse järel. Teavituse töötlemine kaks korda ei tohi luua topelttäitmisi, topelt-tagasimakse kirjeid ega topeltkliendikirju.
* Toimige alles pärast andmete toomist. Ärge kunagi tegutsege ainult teavituse koormuse põhjal – tooge makse või makselüüsi token API kaudu ja tegutsege kinnitatud oleku põhjal.
* Arvestage ebakorrapäraste ja koondunud sündmustega. Toimige alati API viimase kinnitatud oleku põhjal, mitte saabumise järjekorda eeldades.
* Pidage auditi jälge. Logige vastuvõetud teavitused koos ajatemplitega – need on tugijuhtumite ja kooskõlastamise jaoks hindamatud.

### Tarne korduskatsetused ja vahele jäänud teavitused

Kui teie lõpp-punkt on ajutiselt kättesaamatu või ei kinnita teavitust, proovib makselüüs tarne automaatselt uuesti, kasutades järjest pikenevat korduskatsete ajakava. Kui kõik korduskatsete katsed ammenduvad, sellele sündmusele enam teavitusi ei saadeta.

Kujundage süsteem nii, et see arvestaks võimaliku vahelejäänud teavitusega:

* Jälgige oma lõpp-punkti kättesaadavust ja veamäära – rikkis lõpp-punkt ebaõnnestub kliendi vaates vaikselt.
* Pärast katkestust või vahelejäänud teavitusi kontrollige üle hiljutised tellimused, mis on endiselt ootel, ja värskendage nende olekut API kaudu.

### Seadistus

* Määrake oma Callback URL aadressil Kaupleja portaal → Seaded → Poe seaded → Tehniline teave. Igal poel on oma konfiguratsioon.
* Konfigureerige Sandbox ja Production eraldi – nii tagate, et testteavitused ei jõua kunagi teie tootmislõpp-punkti ja vastupidi.

### Testimine

Kontrollige oma veebikonksude käsitlemist Sandboxi keskkonnas enne tööle minekut:

* Edukad, ebaõnnestunud, tühistatud ja poolelijäänud maksejuhtumid – kontrollige, et igal juhul jõuab teavitus kohale ja tellimus uuendatakse õigesti.
* Tagasimakse juhtumid – kontrollige, et tagasimaksest tingitud olekumuutus jõuab teie süsteemidesse.
* Topelttarne – kontrollige, et sama teavituse kaks korda töötlemine ei loo duplikaate.
* Lõpp-punkti kättesaamatus – võtke oma lõpp-punkt maha, sooritage testmakse, tooge see tagasi üles ja kontrollige taastumist API kooskõlastamise kaudu.

### Korduma kippuvad küsimused

#### Kas mul on vaja veebikonksusid, kui kasutan Hosted Checkouti?

Jah – hostitud leht haldab kliendikogemust, kuid teie tellimuse töötlemine peab ikkagi teadma makse tulemust. Kliendi tagasipöördumine teie saidile ei ole maksekinnitus. Selle kinnitab veebikonks või API olekupäring.

#### Kas mul on vaja veebikonksusid, kui kasutan Web Pluginit?

Veebipluginid sisaldavad tehingu oleku käsitlemist oma standardse funktsionaalsuse osana. Need töötlevad veebikonksusid ja uuendavad tellimuste olekuid. Te ei rakenda lõpp-punkti ise.

#### Mis juhtub, kui minu server oli teavituse saatmise ajal maas?

Makselüüs proovib tarne automaatselt uuesti, kasutades järjest pikenevaid intervalle. Kui kõik korduskatsetused ammenduvad, seda teavitust uuesti ei saadeta – kooskõlastage Get Payment Information API ja Kaupleja portaali kaudu, et jõuda järele kõikidele vahelejäänud olekumuutustele.

#### Kas ma võin sama teavitust kaks korda saada?

Jah – näiteks kui teie lõpp-punkt vastas aeglaselt ja käivitati korduskatse. Kujundage töötlus idempotentseks, nii et duplikaadil poleks mõju.

#### Kuidas ma tean, et teavitus on ehtne?

Ärge tegutsege ainult teavituse sisu põhjal. Kasutage seda ainult päästikuna ja tooge makse üksikasjad autentitud Get Payment Information API kaudu – autoriteetne olek tuleb alati API-st, nii et võltsitud teavitus ei saa põhjustada vale täitmist.

#### Milliste olekute kohta ma teavitusi saan?

Iga makse olekumuutus tekitab teavituse – vt Payment Statuses (Cards) ja Pay by Bank › Payment Statuses, et näha olekumudeleid ja soovitatavat tegevust iga oleku korral.

### Seotud dokumentatsioon

* [Makseolekud (kaardid)](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/makse-olekud.md)
* [Pay by Bank › Makseolekud](/seb-docs-draft/seb-docs-public-et/makseviisid/pay-by-bank/makse-olekud.md)
* [Ühtne kaupmehe API](/seb-docs-draft/seb-docs-public-et/integratsioon/kaupmehe-api.md)
* [Tokeniseerimine](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/tokeniseerimine.md)
* [Merchant Portal](/seb-docs-draft/seb-docs-public-et/juhendid/kaupmehe-portaal.md)
* [Testimine](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/testimine.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/integratsioon/kaupmehe-api/webhookid.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.