> 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/majutatud-kassavaade.md).

# Majutatud kassavaade

Võtke veebimakseid vastu turvalise kassalehe kaudu, mida majutab e-kaubanduse makselüüs.

Hosted Checkout pakub valmis kasutamiseks makseliidest, kus kliendid saavad valida saadaoleva makseviisi, sisestada või kinnitada oma makseandmed ning lõpetada kõik nõutavad autentimistoimingud.

Teie server loob makse Merchant API kaudu ning saab vastu Payment ID ja kassalehe URL-i. Suunate kliendi sellele URL-ile ja kinnitate makse tulemuse callback-teavituste ning Merchant API kaudu.

{% hint style="warning" %}
**Ärge käsitlege kliendi naasmist teie veebisaidile või rakendusse maksekinnitusena.** Kasutage callback-teavitust käivitajana, pärige Gatewayst ajakohane makseteave ning täitke tellimus alles pärast nõutud tasutud oleku kinnitamist.
{% endhint %}

### Miks kasutada Hosted Checkouti?

Hosted Checkout on hea valik, kui soovite vastu võtta mitut makseviisi ilma oma makseliidest ehitamata ja hooldamata.

| Gateway haldab                                      | Teie teostate                                |
| --------------------------------------------------- | -------------------------------------------- |
| Kliendile kuvatava makselehe                        | Teie tellimuse- ja kassavoo                  |
| Makseviisi valiku                                   | create-payment API päringu                   |
| Makseandmete kogumise                               | Payment ID salvestamise                      |
| Kliendi autentimise                                 | Kliendi ümbersuunamise                       |
| Pankadele ja rahakotiteenuse pakkujatele üleandmise | Callback-teavituste töötlemise               |
| Responsiivse kassakogemuse                          | Oleku kinnitamise ja tellimuse värskendamise |

Hosted Checkout võib vähendada teie integratsioonikoormust ja teie süsteemide kokkupuudet tundlike kaardiomaniku andmetega. Kuna makselehte käitatakse Gateway keskkonnas, ei pea makseandmed läbima teie rakendust. Teie vastutate endiselt oma kehtivate PCI DSS kohustuste täitmise eest.

#### Kaaluge Hosted Checkouti, kui soovite

* Valmis kasutamiseks makselehte.
* Mitut makseviisi ühe integratsiooni kaudu.
* Gateway poolt hallatavaid autentimisvooge.
* Responsiivset kogemust nii lauaarvutis kui ka mobiilis.
* Konfiguratsioonipõhist brändingut, mitte täielikult kohandatud makseliidest.

#### Kaaluge mõnda muud integratsiooni, kui vajate

* Täielikku kontrolli makselehe paigutuse ja käitumise üle.
* Makseandmete kogumist omaenda liidese kaudu.
* Kohandatud kassaloogikat, mis ei ole Hosted Checkouti konfiguratsiooni kaudu saadaval.

Vt **Valige oma integratsioon** et võrrelda Hosted Checkouti Merchant API, veebipluginatega ja Mobile SDK-ga.

### Kuidas

```mermaid
sequenceDiagram
    participant C as Klient
    participant M as Kaupmees
    osaline G kui e-kaubanduse makselüüs
    osaline P kui pank / makseteenuse pakkuja

    C->>M: Alustab kassaprotsessi
    M->>G: Loob makse
    G-->>M: Payment ID + kassalehe URL
    M->>M: Salvestab Payment ID

    M-->>C: Suunab Hosted Checkouti
    C->>G: Valib makseviisi
    G->>P: Töötleb makse / autentimise
    P-->>G: Makse tulemus

    G-->>C: Suunab tagasi kaupmehe juurde

    G-->>M: Callback-teavitus

    M->>G: Hangib makseteabe
    G-->>M: Ajakohane makseolek

    M->>M: Uuendab tellimust
```

Voo moodustavad viis peamist sammu:

1. Teie server loob kliendi algatatud makse.
2. Gateway tagastab Payment ID ja kassalehe URL-i.
3. Salvestate Payment ID ja suunate kliendi ümber.
4. Klient lõpetab makse Hosted Checkoutis.
5. Teie taustsüsteem kinnitab tulemuse callbacki ja Merchant API kaudu.

Hosted Checkoutis saab kuvada kaarte, digitaalseid rahakotte, maksmist panga kaudu ning muid poe jaoks lubatud ja tehingule kohaldatavaid viise. Täpne klienditeekond sõltub valitud makseviisist, kuid kaupmehe integratsioon jääb samaks.

### Enne alustamist

Veenduge, et teil on:

* Sandbox-pood.
* Poe OAuthi volitused.
* Nõutud makseviisid lubatud.
* HTTPS-URL, kuhu klient saab naasta.
* HTTPS-i Callback-URL makseteavituste jaoks.
* Kaupmehe tellimus, mida saab siduda Gateway Payment ID-ga.

Konfigureerige enne arenduse alustamist Sandboxi volitused, tagasipöördumise URL-id, Callback-URL-id ja makseviisid. Sandboxi ja tootmise konfiguratsioone hallatakse eraldi.

Vt:

* **kiirkäivitus**
* **Integratsiooni kontrollnimekiri**
* **Kaupmehe portaal — poe seaded**
* **Autentimine**
* **Testi-/Sandboxi juhend**

### Integreeri Hosted Checkout

#### 1. Loo makse

Kasutage oma taustsüsteemist Merchant API-t kliendi algatatud makse loomiseks.

Esitage makse tuvastamiseks ja töötlemiseks vajalik teave, sh:

* Teie pood.
* Teie kaupmehe tellimuse number.
* Maksesumma ja valuuta.
* URL, kuhu klient peaks naasma.

Vajaduse korral saate esitada ka täiendavaid tellimuse, kliendi, aadressi, ostukorvi, lokaadi ja tokeni seadistamise andmeid.

Praegune Merchant API kirjeldab Hosted Checkouti ühe viisina, kuidas jätkata kliendi algatatud makset pärast selle loomist. API kasutab OAuth 2.0 Client Credentials'i ja nõuab unikaalset päringuidentifikaatorit.

Vt **Merchant API — Kliendi algatatud makse loomine** täieliku päringuskeemi, valideerimisreeglite ja näidete jaoks.

{% hint style="info" %}
Arvutage maksesumma oma serveris. Ärge usaldage summat, mille esitab ainult brauseri või mobiilse kliendi kood.
{% endhint %}

#### 2. Salvesta Payment ID

create-payment vastus identifitseerib makse ja annab URL-i, mida kasutatakse Hosted Checkouti avamiseks.

Enne kliendi ümbersuunamist salvestage Payment ID oma kaupmehe tellimuse juurde.

Teil on seda vaja, et:

* Kätte saada praegune makseolek.
* Töödelda callback-teavitusi.
* Leida makse kaupmehe portaalist.
* Siduda makse tellimusega.
* Uurida tehingut koos toega.

{% hint style="info" %}
**Salvestage Payment ID enne kliendi ümbersuunamist.**
{% endhint %}

Kasutage iga tellimuse jaoks unikaalset kaupmehe tellimuse numbrit või viidet, et lihtsustada vastavusse viimist ja tõrkeotsingut.

***

#### 3. Suuna klient ümber

Suunake kliendi brauser Gateway tagastatud kassalehe URL-ile.

Kasutage URL-i täpselt sellisel kujul, nagu see tagastati. Ärge koostage, muutke ega kasutage Hosted Checkouti URL-i teise tellimuse jaoks uuesti.

Hosted Checkoutis saab klient:

1. Vaadata makseteavet.
2. Valida saadaoleva makseviisi.
3. Sisestada või kinnitada oma makseandmed.
4. Lõpetada nõutav autentimine.
5. Naasta teie veebisaidile või rakendusse.

Lehte majutab Gateway ning see on loodud töötama toetatud lauaarvuti-, tahvelarvuti- ja mobiilseadmetes.

Kliendile kuvatavad makseviisid võivad sõltuda:

* Kaupmehe lepingust ja poe konfiguratsioonist.
* Valuutast ja turust.
* Kliendi riigist.
* Seadme ja brauseri toest.
* Välise panga, rahakoti või teenusepakkuja saadavusest.

Vt **Makseviisid** meetodipõhise saadavuse, autentimise, olekute ja klienditeekondade kohta.

### Maksetulemuse käsitlemine

Hosted Checkout kasutab kahte eraldi tagasitee rada.

| Brauseri tagastus                                 | Callback-teavitus                                |
| ------------------------------------------------- | ------------------------------------------------ |
| Tagastab kliendi teie veebisaidile või rakendusse | Teavitab teie taustsüsteemi, et makseolek muutus |
| Kasutatakse kliendikogemuse jaoks                 | Kasutatakse tellimuse töötlemise käivitamiseks   |
| Sõltub kliendi brauserist                         | Edastatakse sõltumatult kliendist                |
| Klient ei pruugi kunagi naasta                    | Ebaõnnestunud edastust proovitakse uuesti        |
| Mitte maksekinnitus                               | Järgneb makseteabe päring                        |

Klient võib brauseri sulgeda, ühenduse kaotada või lahkuda makseteekonnalt ilma teie veebisaidile naasmata. Seetõttu ei tohi teie tellimus sõltuda üksnes brauseri ümbersuunamisest.

#### Kui klient naaseb

Kasutage tagasipöördumislehte sobiva sõnumi kuvamiseks, näiteks:

* Makse edukas.
* Makse on endiselt töötlemisel.
* Makse tühistatud.
* Makse ebaõnnestus.

Teie tagasipöördumisleht võib küsida teie taustsüsteemilt viimast teadaolevat tellimuse olekut. See ei tohi tellimust iseseisvalt täita üksnes seetõttu, et klient jõudis lehele.

Kui lõplik olek pole veel saadaval, jätke tellimus ootele ja öelge kliendile, et kinnitus on veel pooleli.

#### Kui saate callbacki

Pärast callbacki saamist:

1. Kinnitage teate vastuvõtt.
2. Hankige ajakohane makseteave autentitud API kaudu.
3. Veenduge, et makse kuulub eeldatud tellimusele ja poele.
4. Uuendage tellimust kinnitatud makseoleku põhjal.
5. Veenduge, et täitmine toimuks ainult üks kord.

Callback tuvastab makse ja selle uue oleku. Gateway dokumentatsioon juhendab kaupmehi pärast teavituse saamist pärima ajakohased makseandmed. Ebaõnnestunud callbacki edastusi proovitakse uuesti kasvavate viivitustega.

Ärge kasutage ainsa tõeallikana ainult callbacki payloadi. Callbacki töötlemist, korduskatseid, topeltedastust, idempotentsust ja vastavusse viimist käsitletakse **Tagasihelistamise teavitused**.

### Täida tellimus

Täitke tellimus alles pärast sobiva tasutud oleku pärimist ja kinnitamist.

| Kinnitatud tingimus                                   | Soovitatav toiming                      |
| ----------------------------------------------------- | --------------------------------------- |
| Kaardimakse on kinnitatud                             | Käsitlege tellimust tasutuna            |
| Pay by Bank makse on arveldatud                       | Käsitlege tellimust tasutuna            |
| Makse on endiselt töötlemisel                         | Jätke tellimus ootele                   |
| Makse on autoriseeritud, kuid mitte kinnitatud        | Ärge käsitlege seda täielikult tasutuna |
| Makse on tühistatud, ebaõnnestunud või pooleli jäetud | Ärge täitke                             |
| Makse on tagastatud                                   | Uuendage tellimust ja finantsandmeid    |

Tasutud olek erineb makseviiside lõikes. Näiteks Pay by Banki puhul kasutab makse `SETTLED` asemel kaardipõhist `AUTHORIZED` ja `CAPTURED` mudelit.

Vt:

* **Makseolekud**
* **Kaardid**
* **Pay by Bank**
* **Tagasihelistamise teavitused**

### Kliendikogemus ja kohandamine

Hosted Checkouti saab konfigureerida nii, et see kajastaks teie visuaalset identiteeti teie poe jaoks lubatud valikute piires.

Sõltuvalt teie konfiguratsioonist ja juurdepääsuõigustest võib kohandamine hõlmata:

* Kaupmehe logo.
* Esmaseid ja teisejärgulisi värve.
* Toetatavad fondid.
* Nupu- ja nurga stiile.
* Vaikekeelt.
* Makseviiside nähtavust, järjestust ja rühmitamist.
* Laua- ja mobiilivaadet.

Kohandamine on piiratud Gateway pakutavate valikutega. See ei võimalda muudatusi turbekontrollides, autentimisvoogudes, maksetöötlusloogikas ega pakkuja juhitud liidestes.

Hosted Checkout toetab algse lahenduse ulatuses inglise, läti, eesti ja leedu keelt. Inglise keel on varundkeelena kasutusel. Leht saab valida toetatud keele seadistatud eelistuse või kliendi brauseri või seadme lokaadi põhjal.

Välised ekraanid võivad Hosted Checkoutist erineda. Näiteks võidakse klient suunata:

* Nende kaardi väljastajale 3-D Secure'i väljakutse jaoks.
* Nende pangale Pay by Banki autentimiseks.
* Rahakotiteenuse pakkujale nagu PayPal, Apple Pay või Google Pay.

Vt **Kaupmehe portaal — kassalehe koostaja** saadaolevate konfiguratsioonivalikute jaoks.

### Testige oma integratsiooni

Viige kogu arendus ja valideerimine enne tootmise aktiveerimise taotlemist lõpule Sandboxis.

Hosted Checkouti puhul testige vähemalt:

* Õnnestunud makset.
* Tagasilükatud või ebaõnnestunud makset.
* Kliendi tühistamine.
* Kliendi loobumist.
* Klienti, kes maksab, kuid ei naase teie veebisaidile.
* Callbacki edastust ja makseoleku päringut.
* Iga teie poe jaoks lubatud makseviisi.
* Laua- ja mobiiliklienditeekondi.

Üldine integratsiooni kontrollnimekiri nõuab samuti vajaduse korral ümbersuunamiste, callback-teavituste, tellimuse kinnituse, tagasimaksete, kinnitamiste, tühistamiste ja topeltkäsitlemise testimist.

Sandbox pakub piiratud Hosted Checkouti kogemust ega pruugi sisaldada kõiki tootmise funktsioone või makseviise.

Vt **Testi-/Sandboxi juhend** järgmiste jaoks:

* Testmakseandmed.
* Toetatud Sandboxi makseviisid.
* Autentimisstsenaariumid.
* Eeldatavad olekud.
* Vea- ja tühistamisjuhtumid.
* Callbacki töökindluse testimine.

### Mine reaalajas

Enne reaalajas maksete töötlemist:

* Tee läbi **Käivitamise kontrollnimekiri**.
* Aktiveerige ja konfigureerige tootmispood.
* Genereerige tootmisvolitused.
* Konfigureerige tootmise tagasipöördumise ja Callback-URL-id.
* Kinnitage lubatud makseviisid ja valuutad.
* Vaadake üle Hosted Checkouti bränding ja keeled.
* Viige läbi kontrollitud väikese summaga tootmismakse.
* Kontrollige callbacki töötlemist, tellimuse uuendusi ja vastavusse viimist.

Ärge kasutage tootmises Sandboxi volitusi ega lõpp-punkte.

### Järgmised sammud

Jätkake dokumentatsiooniga, mis on teie rakenduse jaoks asjakohane:

* **Kaupmehe API** — maksete loomiseks ja makseteabe pärimiseks.
* **Tagasihelistamise teavitused** — makseoleku muudatuste usaldusväärseks töötlemiseks.
* **Testi-/Sandboxi juhend** — testandmete ja lõpp-lõpuni stsenaariumide jaoks.
* **Makseviisid** — kaartide, rahakottide ja Pay by Banki jaoks.
* **Makseolekud** — maksete elutsükli ja kaupmehe toimingute mõistmiseks.
* **Kaupmehe portaal — poe seaded** — volituste ja tehniliste URL-ide jaoks.
* **Kaupmehe portaal — kassalehe koostaja** — brändingu ja kassakonfiguratsiooni jaoks.
* **Turvalisus ja vastavus** — PCI DSS-i ja kaupmehe turvavastutuse jaoks.
* **Käivitamise kontrollnimekiri** — valmistada oma integratsioon ette tootmiseks.


---

# 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/majutatud-kassavaade.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.