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

# Konfigureerimine

Konfigureerige SEB e-kaubanduse makselüüsi OpenCarti laiendus

Ava **Laiendid → Laiendid**, valige tüüp **Maksed**, leidke **SEB e-kaubanduse makselüüs** ja valige **Muuda**.

## Sätete viide

| Säte                                 | Mida see teeb                                                                                                                                                                                    | Vaikimisi                                                               | Millal muuta                                                                                                                                        |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Lubatud**                          | Näitab/peidab makseviisi kassas                                                                                                                                                                  | Väljas                                                                  | Luba pärast volituste sisestamist                                                                                                                   |
| **Keskkond**                         | *Sandbox* (test) või *Reaalne*. Näidatavad volituse väljad muutuvad vastavalt teie valikule; iga keskkond säilitab oma paari ning laiendus suunab automaatselt vastavatele lüüsi lõpp-punktidele | Sandbox                                                                 | Lülitu reaalrežiimi alles pärast [testimist](/seb-docs-draft/seb-docs-public-et/integratsioon/veebipluginad/opencart/testimine-ja-kaikulaskmine.md) |
| **Pealkiri**                         | Makseviisi nimi, mida teie klient näeb                                                                                                                                                           | Veebimakse                                                              | Kohandage või nimetage ümber vabalt (nõutav)                                                                                                        |
| **Kirjeldus**                        | Meetodi juures kuvatav tekst                                                                                                                                                                     | Teid suunatakse turvalisele makselehele ostu lõpetamiseks.              | Tehke ümbersuunamine selgelt arusaadavaks (nõutav)                                                                                                  |
| **Maksevärava API URL**              | Teie SEB E-commerce Payment Gateway baas-hostinimi, mis on toodud teie liitumisteabes. Laiendus tuletab sellest valitud keskkonna API- ja identiteedilõpp-punktid                                | `https://ecommerce.sebgroup.com`                                        | Sea üks kord (kohustuslik)                                                                                                                          |
| **OAuth2 kliendi ID**                | Poe mandaadid Kaupmehe portaalist → **Sätted → Poe sätted → Tehniline teave**                                                                                                                    | —                                                                       | Iga keskkonna kohta                                                                                                                                 |
| **OAuth2 kliendi saladus**           | Selle salajane vaste                                                                                                                                                                             | —                                                                       | Uuenda siin alati, kui see on portaalis uuendatud                                                                                                   |
| **Salvestatud kaardid**              | Võimaldab sisseloginud klientidel salvestada kaardi, millega nad maksavad, ja hiljem ühe klõpsuga sama kaardiga maksta. Vt [Salvestatud kaardid](#saved-cards)                                   | Väljas                                                                  | Luba siis, kui soovite pakkuda ühe klõpsuga kassalahendust                                                                                          |
| **Salvestatud kaardi kasutusviisid** | Milleks äsja salvestatud kaarti võib kasutada: *ühe klõpsuga maksed*, või *ühe klõpsuga ja kaupmehe algatatud maksed*. Rakendub ainult juhul, kui **Salvestatud kaardid** on sisse lülitatud     | Ühe klõpsuga maksed                                                     | Jätke vaikimisi valik — laiendus teeb makseid ainult siis, kui klient on kohal                                                                      |
| **Tagasikutse teavituse URL**        | Ainult lugemiseks. Registreerige see Kaupmehe portaalis oma poe tagasikutse URL-ina                                                                                                              | `https://<your-domain>/index.php?route=extension/egw_checkout/callback` | Vt [Registreeri tagasikutse URL](#register-the-callback-url)                                                                                        |

**Salvesta.** Puuduvatest nõutud väljadest valitud keskkonna jaoks antakse teada.

![Laienduse seadistusvorm, kus on näha Lubatud, Keskkond = Sandbox, Pealkiri, Kirjeldus, lüüsi API URL, OAuth2 kliendi ID/saladus (varjatud) ja kirjutuskaitstud Callback Notification URL.](https://4089891531-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuBDtfypkI85zidcVwaDj%2Fuploads%2F5z6y0K6tqpigYyC2jLLo%2Foc-settings-panel.png?alt=media)

Tellimuse olekud: laiendus kirjutab OpenCarti vaikimisi tellimuse olekud (*Ootel*, *Töötlemisel*, *Tühistatud*). Kui teie poes on vaikimisi olekuid ümber nummerdatud või eemaldatud, võtke enne käivitamist ühendust SEB toega.

## Salvestatud kaardid

Valikuline, **vaikimisi välja lülitatud** — koos **Salvestatud kaardid** Kui see on väljas, ei muutu teie klientide jaoks midagi. Lülitage see ülalolevates seadistustes sisse ja salvestage.

* **Kaardi salvestamine.** Sisseloginud kliendid näevad märkimata **Salvesta minu kaart kiirema kassaprotsessi jaoks** valik, kui the *Veebimakse* meetod on valitud. Kui nad selle märgivad, salvestab lüüs pärast õnnestunud makset kaardi jaoks tokeni. Teie pood säilitab ainult selle tokeni ja kuvatavad andmed (kaardi mark, neli viimast numbrit, kehtivusaeg, kaardiomaniku nimi, kaardi kujutis) — mitte kunagi kaardinumbrit. Külaliskassas seda valikut kunagi ei pakuta.
* **Salvestatud kaardiga maksmine.** Hiljem tehtud tellimustes ilmub iga salvestatud kaart eraldi makseviisi valikuna. Ühe valimine jätab kaardi sisestamise vahele; klient suunatakse lüüsi ainult 3-D Secure'i jaoks.
* **Kaartide haldamine.** Kliendid näevad oma kaarte jaotises **Minu konto → Makseviisid** ning saab neid seal kustutada. Kustutamine eemaldab kaardi teie poest ja palub lüüsil selle vastuvõtmise lõpetada. Kui kustutate kliendi halduspaneelis, eemaldatakse tema salvestatud kaardid teie poest; lüüsi juures olevad tokenid jäävad alles.
* **Vajab aadressi.** Lüüs saab salvestatud kaarti seadistada või kasutada ainult siis, kui maksel on arveldusaadress. OpenCart ei kogu seda alati, seega kasutab laiendus esmalt tellimuse makseaadressi, seejärel tarneaadressi, seejärel kliendi vaikimisi kontoaadressi ning pakub **Salvesta minu kaart** ainult siis, kui mõni neist on olemas.
* **Vajab Session Samesite Cookie = Lax.** Salvestatud kaardid vajavad **Seansi SameSite-küpsis** seatud väärtuseks *Lax* (vaata [Installimine](/seb-docs-draft/seb-docs-public-et/integratsioon/veebipluginad/opencart/installimine.md)) ning kliendi aadressi andmebaasis. Ilma *Lax*, salvestatakse kliendi soovitud kaart alles pärast callback-teavituse saabumist.
* **Selle väljalülitamine** peidab selle valiku ja salvestatud kaardid kassas. Salvestatud kaarte ei kustutata.
* **Kaardipildid** on kaardikujutised, mida lüüs tagastab; ilma nendeta kaart kuvatakse ainult tekstina.
* Mainige salvestatud kaarte oma poe privaatsusteabes vastavalt teie ettevõtte tegevusele.

Testige seda kõigepealt Sandboxis testkaardiga, mille leiate [Testimine ja käivitamine](/seb-docs-draft/seb-docs-public-et/integratsioon/veebipluginad/opencart/testimine-ja-kaikulaskmine.md).

## Registreeri tagasikutse URL

1. Kopeerige **Tagasikutse teavituse URL** seadistuste ekraanilt.
2. Kaupmehe portaalis aadressil <https://merchantportal.ecommerce.sebgroup.com> minge jaotisse **Sätted → Poe sätted → Tehniline teave** ja salvestage see oma poe **tagasikutse URL-ina**.
3. Kontrollige Sandboxi tellimusega ([Testimine ja käivitamine](/seb-docs-draft/seb-docs-public-et/integratsioon/veebipluginad/opencart/testimine-ja-kaikulaskmine.md)).

⚠️ **Ärge kunagi lubage vahemälul, CDN-il või turvakihil vahemällu salvestada ega blokeerida POST-päringuid callback-teele.** Blokeeritud või vahemällu salvestatud callback takistab tellimuse olekul kunagi kajastamast lõpule viidud makset.

## Kuidas tagasikutse teavitusi kontrollitakse

Tellimuse terviklikkus tugineb siin kontrollimisele, mitte allkirjale: callback-lõpp-punkt on avalik ja SEB E-commerce Payment Gateway ei allkirjasta oma teavitusi, seega ei saa teie pood krüptograafiliselt tõendada, kes selle saatis. Selle asemel ei usalda laiendus kunagi sõnumi sisu:

* Teavitus peab viitama tellimusele, mille salvestatud tehingu ID kattub sõnumis oleva makse ID-ga. Tundmatud või mittevastavad paarid lükatakse tagasi.
* Seejärel küsib laiendus lüüsilt oma autentitud API-ühenduse kaudu, milline on tegelik makse olek, ning rakendab ainult seda. Sõnum, mis väidab, et makse õnnestus, ei saa viia tellimust *Töötlemisel* välja arvatud juhul, kui lüüs teatab selle iseseisvalt tasutuks.

## Sandbox vs reaalrežiim

Muutuvad ainult lõpp-punktid ja volituste paar. Testige kõigepealt Sandboxis; reaalrežiimi minek on: Keskkond → *Reaalne*, reaalvolitused, Salvesta, üks päris testtellimus.


---

# 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/konfigureerimine.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.
