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

# Tokeniseerimine

Salvestage makseandmed turvaliselt ja kasutage neid uuesti ilma tundlikke kaardiandmeid käsitlemata.

Tokeniseerimine on protsess, mille käigus asendatakse tundlikud makseandmed, näiteks Primary Account Number (PAN), ainulaadse mittetundliku väärtusega, mida nimetatakse tokeniks. Tokene saab turvaliselt talletada ja tulevaste maksete jaoks uuesti kasutada, ilma et algsed kaardiandmed avalikuks tuleksid.

SEB Ecommerce Payment Gateway loob ja haldab tokeneid teie eest. Kaardinumbreid salvestamata talletavad teie süsteemid ainult maksevärava tokeni viidet – identifikaatorit, mille lisate hilisematesse maksetaotlustesse. Kogu tundlik kaardiinfo jääb maksevärava PCI DSS-iga vastavasse keskkonda ega avaldu kunagi teie süsteemidele ega töötajatele.

Tokeniseerimine on järgmiste maksevärava funktsioonide aluseks:

* [Salvestatud makseandmed](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/salvestatud-makseandmed.md) (kaardid failis)
* [Ühe klõpsuga maksed](/seb-docs-draft/seb-docs-public-et/omadused/uhe-klopsuga-maksed.md)
* [Korduvmaksed](/seb-docs-draft/seb-docs-public-et/omadused/korduvad-maksed-ja-tellimused.md) (tellimused)
* [Kaupmehe algatatud tehingud ](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/salvestatud-makseandmed/kaupmehe-algatatud-tehingud-mit.md)(MIT)

{% hint style="info" %}
Makse tokenil ei ole Makseväravast väljaspool iseseisvat väärtust ning seda ei saa kasutada algsete kaardiandmete taastamiseks.
{% endhint %}

### Võimaluste kokkuvõte

<table><thead><tr><th valign="top">Võimalus</th><th valign="top">Toetus</th></tr></thead><tbody><tr><td valign="top">Makseviisid</td><td valign="top">Maksekaardid (Visa, Mastercard)</td></tr><tr><td valign="top">Sisemine (maksevärava) tokeniseerimine</td><td valign="top">Toetatud</td></tr><tr><td valign="top">Võrgutokeniseerimine</td><td valign="top">Visa Token Management Service (TMS), Mastercard Secure Card on File (SCOF)</td></tr><tr><td valign="top">Tokenihoidla</td><td valign="top">PCI DSS-iga vastav, hallatav maksevärava poolt</td></tr><tr><td valign="top">Kliendi algatatud tehingud (CIT)</td><td valign="top">Toetatud</td></tr><tr><td valign="top">Kaupmehe algatatud tehingud (MIT)</td><td valign="top">Toetatud, sealhulgas vajaduse korral EMV® 3DS Requestor-Initiated (3RI) autentimine</td></tr><tr><td valign="top">Tokeni elutsükli haldus</td><td valign="top">Kaardiskeemidelt tulevad automaatsed uuendused (võrgutokenid)</td></tr><tr><td valign="top">Tokeni oleku teavitused</td><td valign="top">Tagasiside teavitused (webhookid)</td></tr><tr><td valign="top">Integreerimisvõimalused</td><td valign="top">Kaupmehe API, hostitud kassaleht</td></tr><tr><td valign="top">Sandboxi testimine</td><td valign="top">Saadaval</td></tr></tbody></table>

Üksikute võimaluste saadavus sõltub teie kaupmehe lepingust, lubatud teenustest ja omandamiskonfiguratsioonist.

### Kuidas tokeniseerimine töötab

Token luuakse esialgse kliendi algatatud tehingu (CIT) käigus, mille jooksul klient annab selgesõnalise nõusoleku, et tema makseandmeid võib tulevasteks kasutusteks talletada.

Tüüpiline protsess on järgmine:

1. Esialgne makse (CIT). Klient lõpetab makse ja nõustub oma makseandmete salvestamisega.
2. Tokeni loomine. Maksevärav salvestab makseandmed turvaliselt oma PCI DSS-iga vastavasse tokenihoidlasse ja genereerib tokeni. Sõltuvalt teie seadistusest võib samuti väljastada skeemi poolt emiteeritud võrgutokeni.
3. Tagastatakse tokeni viide. Tokeni ID tagastatakse teile maksevastes koos muude makseandmetega. Salvestage see viide oma süsteemides kliendiprofiili juurde.
4. Järgmised maksed. Tulevaste maksete puhul lisage kaardiandmete asemel maksetaotlusse tokeni ID. Maksevärav lahendab tokeni ja töötleb tehingu tavapäraste autoriseerimise, broneerimise, tagasipööramise ja tagasimakse protsesside kaudu.

Järgmised maksed võivad olla kas kliendi algatatud tehingud (näiteks ühe klõpsuga ost, kui klient on kohal) või kaupmehe algatatud tehingud (näiteks igakuine tellimustasu, mida töödeldakse ilma kliendi aktiivse osaluseta).

{% hint style="warning" %}
Kaardi turvakoodi (CVV/CVC) ei talletata kunagi, isegi tokeniseerimise kasutamisel. See on PCI DSS-i nõue, mis kehtib kõigile kaupmeestele ja teenusepakkujatele.
{% endhint %}

### Tokeni tüübid

Maksevärav toetab kahte teineteist täiendavat tokeniseerimismudelit. Sõltuvalt teie omandamise seadistusest, skeemis osalemisest ja kaupmehe konfiguratsioonist võivad need töötada sõltumatult või koos. Mõlemas mudelis suhtlete ühe maksevärava tokeni viitega – maksevärav haldab aluseks olevaid andmeid läbipaistvalt.

#### Sisemised (maksevärava) tokenid

Sisemise tokeniseerimise korral asendatakse tundlik kaardiomaniku andmestik turvalise, maksevärava loodud tokeniga maksevärava PCI DSS-iga vastavas keskkonnas. Sisemisi tokeneid kasutatakse ainult maksevärava sees tehingute töötlemiseks ja makseandmete taaskasutamiseks.

Sisemine tokeniseerimine:

* Eemaldab toorkaardiandmed teie süsteemidest, vähendades teie PCI DSS-i vastavuse ulatust.
* Võimaldab ühe klõpsuga makseid, korduvtehinguid ja tellimusteenuseid.
* Minimeerib kaardiomaniku andmete lekke riski.

#### Võrgutokenid

Võrgutokeniseerimise korral asendatakse algne PAN kaardiskeemi enda väljastatud ja hallatava võrgutokeniga. Maksevärav integreerub kaardiskeemi tokeniseerimisteenustega, et võrgutokeneid väljastada, talletada ja kasutada tehingute töötlemiseks:

* Visa Token Management Service (TMS) Visa kaardiandmete jaoks.
* Mastercard Secure Card on File (SCOF) ja seotud Mastercardi tokeni elutsükli teenused (sh pärandsed MDES-põhised integratsioonid) Mastercardi kaardiandmete jaoks.

Võrgutokenid järgivad EMV® Payment Tokenisation Specificationi ning on seotud konkreetse kaupmehekontekstiga, mis muudab need pealtkuulamisel kasutuks. Iga tehing on lisaks kaitstud skeemitaseme valideerimisega.

Lisaks turvalisusele pakuvad võrgutokenid ka praktilisi ärilisi eeliseid:

* Automaatne andmete uuendamine. Kui aluskaart väljastatakse uuesti, asendatakse või selle aegumiskuupäev muutub, uuendab kaardiskeem tokenit automaatselt. Salvestatud makseandmed jätkavad toimimist ilma, et klient peaks kaardiandmed uuesti sisestama – eriti väärtuslik tellimuste ja korduvarvelduste puhul.
* Kõrgem heakskiitmismäär. Emiteerijad kiidavad tokeniseeritud tehinguid üldjuhul heaks sagedamini kui PAN-põhiseid tehinguid, kuna skeem valideerib iga tokeni enne, kui autoriseerimine jõuab emiteerijani. Kaardiskeemide andmetel on tokeniseeritud kaardita tehingute heakskiitmismäär märgatavalt kõrgem.
* Väiksem maksefriktsioon. Vähem tagasilükkeid aegunud või asendatud kaartide tõttu tähendab vähem katkestatud tellimusi ja väiksemat tahtmatut kliendikaotust.

#### Võrdlus

<table><thead><tr><th width="146" valign="top">Aspekt</th><th valign="top">Sisemine (maksevärava) token</th><th valign="top">Võrgutoken</th></tr></thead><tbody><tr><td valign="top">Väljastaja</td><td valign="top">SEB e-kaubanduse makselüüs</td><td valign="top">Kaardiskeem (Visa, Mastercard)</td></tr><tr><td valign="top">Asendab</td><td valign="top">PAN maksevärava keskkonnas</td><td valign="top">PAN maksevõrgus</td></tr><tr><td valign="top">Elutsüklit haldab</td><td valign="top">Maksevärav</td><td valign="top">Kaardiskeem; maksevärav töötleb elutsükli sündmused ja uuendab oma kirjeid</td></tr><tr><td valign="top">Automaatsed kaardiuuendused</td><td valign="top">Ei kohaldu</td><td valign="top">Jah (uuesti väljastamine, aegumiskuupäeva uuendused, asendamine)</td></tr><tr><td valign="top">Heakskiitmismäära kasv</td><td valign="top">–</td><td valign="top">Jah, kaardiskeemide poolt teatatud tokeniseeritud tehingute puhul</td></tr><tr><td valign="top">PCI DSS-i ulatuse vähendamine</td><td valign="top">Jah</td><td valign="top">Jah</td></tr><tr><td valign="top">Kaupmehe integratsioon</td><td valign="top">Maksevärava tokeni viide</td><td valign="top">Maksevärava tokeni viide (võrgutoken on kaupmehele läbipaistev)</td></tr></tbody></table>

{% hint style="info" %}
Te ei käsitle võrgutokeneid kunagi otse. Kui võrgutoken on väljastatud, talletab maksevärav selle turvaliselt oma tokenihoidlasse, seob selle vastava kaupmehe või kliendiprofiiliga ning annab teile järgmiste CIT- ja MIT-maksete jaoks maksevärava tokeni viite.
{% endhint %}

### Tokeni elutsükkel

Tokenid on pika elueaga makseandmed. Nende olek määrab, kas neid saab maksetöötluseks kasutada.

Võrgutokenite puhul juhivad elutsükli sündmusi kaardiskeemid ja nende tokeniseerimisteenused. Kui maksevärav saab kaardiskeemilt elutsükli teavituse, uuendab ta vastavad tokenikirjed tokenihoidlas ja kohandab tokeni olekut tehingute töötlemiseks. Need uuendused toimuvad läbipaistvalt – teie integratsioon ja salvestatud tokeni viited jätkavad töötamist ilma muudatusteta.

#### Elutsükli sündmused

<table><thead><tr><th width="129" valign="top">Sündmus</th><th valign="top">Kirjeldus</th><th valign="top">Mõju kaupmehele</th></tr></thead><tbody><tr><td valign="top">Aktiveerimine</td><td valign="top">Token on väljastatud ja kasutamiseks valmis.</td><td valign="top">Tokeni viidet saab kasutada maksete tegemiseks.</td></tr><tr><td valign="top">Uuendus</td><td valign="top">Tokeni metaandmed on muutunud, näiteks pärast kaardi uuesti väljastamist on tekkinud uus aegumiskuupäev.</td><td valign="top">Puudub – uuendus rakendatakse automaatselt.</td></tr><tr><td valign="top">Asendamine</td><td valign="top">Aluskaart asendati (näiteks kadumise või varguse tõttu) ja skeem sidus tokeni uue kaardiga.</td><td valign="top">Puudub – olemasolev tokeni viide jääb kehtima.</td></tr><tr><td valign="top">Peatamine</td><td valign="top">Token on ajutiselt peatatud, näiteks emitendi või kaardiomaniku taotlusel.</td><td valign="top">Tokeniga tehtud maksed lükatakse tagasi kuni selle taasaktiveerimiseni.</td></tr><tr><td valign="top">Deaktiveerimine/kustutamine</td><td valign="top">Token on lõplikult deaktiveeritud.</td><td valign="top">Tokeni viidet ei saa enam kasutada. Paluge kliendil makseviis uuesti esitada.</td></tr></tbody></table>

#### Tokeni oleku teavitused

Maksevärav teavitab teie süsteeme tokeni oleku muudatustest tagasihelistamisteavituste kaudu (webhookid). Kasutage neid teavitusi, et hoida klientide profiilide juurde salvestatud makseviisid ajakohasena – näiteks peitke deaktiveeritud kaart kliendi salvestatud makseviiside hulgast või paluge kliendil enne järgmist tellimustasu lisada uus kaart.

### Kasutusjuhud

#### Ühe klõpsuga maksed

Naasev klient valib salvestatud makseviisi ja kinnitab ostu ilma kaardiandmeid uuesti sisestamata. Makse töödeldakse kliendi algatatud tehinguna, kasutades salvestatud tokenit, ning see võib sõltuvalt regulatiivsetest nõuetest ja emitendi riskihinnangust nõuda EMV® 3-D Secure autentimist.

#### Korduvad maksed ja tellimused

Pärast esialgset CIT-i, mille käigus klient nõustub korduva arveldusega, debiteerite salvestatud tokenit kokkulepitud intervallidega kaupmehe algatatud tehingutena. Vajaduse korral võivad MIT-id kasutada EMV® 3DS Requestor-Initiated (3RI) autentimist ja võivad kvalifitseeruda Tugeva Kliendi Autentimise (SCA) eranditele, sõltuvalt kehtivatest regulatsioonidest ja emitendi autoriseerimisotsusest.

#### Planeerimata kaupmehe algatatud tehingud

Kasutuspõhine arveldamine, viitajaga tasud, täiendamised või kontotasud töödeldakse salvestatud tokeni alusel sündmuse toimumisel, ilma et klient oleks kohal. Iga MIT peab viitama algsele kliendi nõusolekule, mis anti esialgse CIT-i käigus.

Märkus: tokeniseerimine ja kaupmehe algatatud tehingud on toetatud kaardimaksete puhul. CIT/MIT klassifikatsiooni, kliendi nõusoleku nõuete ning Visa ja Mastercardi salvestatud makseandmete raamistiku kohta vt Salvestatud makseandmed.

### Turvalisus ja vastavus

Tokeniseerimine vähendab tundlike makseandmete käitlemist ja suurendab maksetöötluse turvalisust:

* PCI DSS-iga vastav tokenihoidla. Kogu kaardiandmestik talletatakse maksevärava PCI DSS-iga vastavas tokenihoidlas. Toorkaardiandmed ei ole kaupmeestele nähtavad.
* Väiksem PCI DSS-i ulatus. Kuna teie süsteemid talletavad ainult tokeni viiteid, võib tokeniseerimine oluliselt vähendada teie PCI DSS-i vastavuse ulatust. Kohaldatav Self-Assessment Questionnaire (SAQ) määratakse teie täieliku maksekeskkonna ja rakenduse põhjal.
* Sisemine väärtus puudub. Tokenit ei saa kasutada algsete kaardiandmete taastamiseks ning sellel puudub väärtus väljaspool makseväravat.
* Skeemitaseme kaitse. Võrgutokenid väljastatakse ja valideeritakse kaardiskeemide poolt kooskõlas EMV® Payment Tokenisation Specificationiga.
* CVV-d ei talletata. Kaardi turvakoodi (CVV/CVC) ei talletata kunagi pärast autoriseerimist, kooskõlas PCI DSS-i nõuetega.

Kaupmehed ei tohiks kunagi talletada kaardiomaniku andmeid, välja arvatud juhul, kui nende PCI DSS-i vastavuse ulatus seda selgesõnaliselt lubab. Kasutage kaardinumbri talletamise asemel tokeniseerimist.

### Tokeniseerimine ja digitaalsed rahakotid

Digitaalsed rahakotid nagu Apple Pay ja Google Pay kasutavad oma teenusepakkujapõhiseid tokeniseerimismehhanisme. Klient ei sisesta kaardiandmeid käsitsi, vaid need hangitakse valitud rahakotist turvaliselt ja esitatakse makseväravale maksetokeni kujul. Neid rahakotitokeneid juhivad rahakoti pakkuja ja kohaldatavad kaardiskeemi reeglid ning need erinevad sellel lehel kirjeldatud maksevärava ja võrgutokenitest.

Üksikasju vt rahakottide jaotisest Apple Pay ja Google Pay.

### Kaupmehe nõuded

Enne tokeniseerimise kasutamist veenduge, et:

* Tokeniseerimine ja salvestatud makseandmed on teie kaupmehe lepingus kaasatud ja teie kaupmehekonto jaoks lubatud.
* Teie kassatöövoog hangib kliendi selgesõnalise nõusoleku enne makseandmete talletamist. Nõusolek peaks selgelt kirjeldama andmete talletamise eesmärki, maksesagedust ja summat või arveldusmudelit (kui kohaldatav), ning tühistamisprotsessi.
* Teie süsteemid talletavad maksevastes tagastatud tokeni ID-d ja viitavad sellele hilisemates maksetaotlustes.
* Teie integratsioon töötleb tokeni oleku teavitusi (webhooke) ja hoiab salvestatud makseviisid ajakohasena.

Võrgutokeniseerimise kättesaadavus sõltub lisaks kaardiskeemi programmiga liitumisest, heakskiitudest ja omandamise konfiguratsioonist.

### Testimine

Viige kogu arendus ja valideerimine enne reaalsete tehingute töötlemist lõpule Sandboxi keskkonnas. Enne tootmise aktiveerimise taotlemist kontrollige:

* Tokeni loomine esialgse kliendi algatatud tehingu käigus, sealhulgas kliendi nõusoleku samm.
* Tokeni ID saadakse maksevastuses ja salvestatakse teie süsteemides õigesti.
* Ühe klõpsuga maksed salvestatud tokeni abil (CIT).
* Korduvad maksed salvestatud tokeni abil (MIT).
* Tagasilükatud makse olukorrad, sealhulgas maksed peatatud või deaktiveeritud tokeniga.
* Tokeni oleku teavitused (webhookid) ja neist tulenevad uuendused teie süsteemides.
* Tagasimaksete töötlemine tokenipõhiste maksete puhul.

### Kaupmehe parimad tavad

Soovitame kaupmeestel:

* Kasutage kaardi numbri talletamise asemel tokeniseerimist.
* Hankige enne makseandmete talletamist kliendi selgesõnaline nõusolek ja säilitage selle nõusoleku tõend.
* Teatage korduva arvelduse tingimustest selgelt ja teavitage kliente enne korduvaid tasusid, kui seda nõuavad kohaldatavad regulatsioonid või kaardiskeemi reeglid.
* Algatage kaupmehe algatatud tehinguid ainult pärast kehtivat kliendi algatatud tehingut.
* Tellige tokeni oleku teavitused ja käsitlege aegunud, asendatud või deaktiveeritud tokeneid nõuetekohaselt.
* Lubage klientidel vaadata, uuendada ja kustutada oma salvestatud makseviise.
* Hoidke oma maksekeskkonnale vastav PCI DSS-i vastavus.

### Korduma kippuvad küsimused

#### Kas token muutub, kui kliendi kaart väljastatakse uuesti?

Ei. Võrgutokenite puhul seob kaardiskeem olemasoleva tokeni automaatselt uue kaardiga ja maksevärav uuendab oma kirjeid läbipaistvalt. Teie salvestatud tokeni viide jääb kehtima ning korduvad maksed jätkuvad katkestusteta.

#### Kas ma saan kasutada ühte tokenit mitmes poes?

Tokenid on seotud kaupmehe või kliendiprofiiliga, mille all need loodi. See, kas tokenit saab jagada mitme teie poe vahel, sõltub teie kaupmehe konfiguratsioonist. Üksikasjade saamiseks võtke ühendust oma SEB esindajaga.

#### Kas CVV talletatakse koos tokeniga?

Ei. Kaardi turvakoodi ei tohi kunagi pärast autoriseerimist talletada, isegi tokeniseerimise kasutamisel. Salvestatud makseandmetega maksed töödeldakse ilma CVV-ta, kooskõlas kaardiskeemi reeglitega salvestatud makseandmete tehingute puhul.

#### Kas tokeniseeritud maksed vajavad endiselt 3-D Secure'i?

Kliendi algatatud tehingud salvestatud tokeniga võivad nõuda EMV® 3-D Secure autentimist sõltuvalt regulatiivsetest nõuetest ja emitendi riskihinnangust. Kaupmehe algatatud tehingud ei kuulu SCA kohaldamisalasse ning võivad vajaduse korral kasutada 3DS Requestor-Initiated (3RI) autentimist; lõplik autoriseerimisotsus jääb alati emitendile.

#### Mis juhtub, kui token deaktiveeritakse?

Tokenile viitavad maksed lükatakse tagasi. Saate tokeni oleku teavituse, et saaksite paluda kliendil uus makseviis esitada.

### Seotud dokumentatsioon

Jätkake järgmiste teemadega:

* [Salvestatud makseandmed](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/salvestatud-makseandmed.md)
* [Kliendi algatatud tehingud (CIT)](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/salvestatud-makseandmed/kliendi-algatatud-tehingud-cit.md)
* [Kaupmehe algatatud tehingud (MIT)](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/salvestatud-makseandmed/kaupmehe-algatatud-tehingud-mit.md)
* [Ühe klõpsuga maksed](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/salvestatud-makseandmed/uhe-klopsuga-maksed.md)
* [Korduvad maksed ja tellimused](/seb-docs-draft/seb-docs-public-et/omadused/korduvad-maksed-ja-tellimused.md)
* [EMV® 3-D Secure (EMV 3DS)](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid/emv-r-3-d-secure-emv-3ds.md)
* [Tagasihelistamise teavitused](/seb-docs-draft/seb-docs-public-et/integratsioon/kaupmehe-api/webhookid.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/makseviisid/kaardid/tokeniseerimine.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.