> 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/omadused/taiendavad-valjad.md).

# Täiendavad väljad

Koguge lisateave, mida teie ettevõte vajab, kui kliendid maksavad makselinkide kaudu.

Täiendavad väljad võimaldavad teil lisada maksetaotlusele kaupmehepõhist teavet, muutmata standardset maksevoogu. Kasutage neid oma viiteandmete lisamiseks tehingule või kliendilt lisateabe küsimiseks hostitud kassavaates.

Näiteks saate kasutada täiendavaid välju tellimuse viite, broneerimisnumbri, osaleja nime, tarnejuhise või muu ostu töötlemiseks vajaliku detaili jaoks.

{% hint style="info" %}
Kättesaadavus ja haldusõigused sõltuvad teie kaupmehe konfiguratsioonist ja teie Müüja portaali kasutajale määratud õigustest.
{% endhint %}

### Võimaluste kokkuvõte

<table><thead><tr><th width="260">Võimalus</th><th>Toetus</th></tr></thead><tbody><tr><td>Väljade haldus</td><td>Looge, aktiveerige ja hallake täiendavaid välju </td></tr><tr><td>Seos makselingiga</td><td>Seostage üks või mitu välja makselingiga</td></tr><tr><td>Müüja sisestatud väärtused</td><td>Eeltäitke väli makselingi loomisel</td></tr><tr><td>Kliendi sisestatud väärtused</td><td>Paluge kliendil kassas väärtus sisestada</td></tr><tr><td>Kohustuslikud väljad</td><td>Märgistage väli kohustuslikuks</td></tr><tr><td>Valideerimine</td><td>Seadistage toetatud reeglid, näiteks minimaalne ja maksimaalne pikkus</td></tr><tr><td>Kliendile kuvatavad sildid</td><td>Seadistage mitmekeelsed väljasildid</td></tr><tr><td>Kassas kuvamine</td><td>Väljad kuvatakse hostitud kassavaates</td></tr><tr><td>Tehinguandmed</td><td>Salvestage müüja sisestatud väärtused tehingu metaandmetena</td></tr><tr><td>Ajaloolised kirjed</td><td>Hilisemad välja muudatused ei muuda olemasolevaid tehinguid</td></tr></tbody></table>

***

### Kuidas täiendavad väljad toimivad

Täiendav väli määratletakse eraldi ja seejärel seostatakse see makselingiga.

Tüüpiline protsess on:

1. [**Looge väli**](/seb-docs-draft/seb-docs-public-et/juhendid/kaupmehe-portaal/votke-makseid-vastu-ilma-integratsioonita/makselingid-ja-qr-koodid.md)**.** Määratlege lisateave, mida soovite koguda või maksele lisada.
2. **Seadistage silt.** Sisestage kliendile kuvatava välja silt, sealhulgas vajadusel mitmekeelsed versioonid.
3. **Aktiveerige väli.** Ainult aktiivseid välju saab kasutada uute makselinkide puhul.
4. **Seostage see ühe** [**makselingiga.**](/seb-docs-draft/seb-docs-public-et/juhendid/kaupmehe-portaal/votke-makseid-vastu-ilma-integratsioonita/makselingid-ja-qr-koodid.md) Valige lingi loomisel üks või mitu täiendavat välja.
5. **Valige välja käitumine.** Eeltäitke väärtus ise või paluge kliendil see kassas sisestada.
6. **Koguge makse.** Seadistatud väli kuvatakse hostitud kassavaates ja väärtus seostatakse sellest tuleneva tehinguga.

{% hint style="info" %}
Täiendavad väljad täiendavad standardset makseteavet. Need ei muuda maksesummat, makseviise, autentimisprotsessi ega muud maksetöötluse loogikat.
{% endhint %}

***

### Välja käitumine

Seadistage, kuidas iga täiendav väli käitub makselingi puhul, millega see on seotud.

| Välja käitumine            | Kuidas see toimib                                                                         | Näide                                                 |
| -------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| Müüja sisestatud väärtus   | Sisestate väärtuse makselingi loomisel. Väärtus salvestatakse tehingu metaandmetena.      | Sisemine tellimusnumber, lepingu viide, kampaaniakood |
| Kliendi sisestatud väärtus | Väli kuvatakse hostitud kassavaates ja klient sisestab väärtuse enne makse lõpuleviimist. | Osaleja nimi, tarnejuhis, broneeringu viide           |

Saadaolev käitumine seadistatakse iga välja ja lingi seose jaoks eraldi.

Teenus kontrollib konfiguratsiooni ja takistab loogiliselt ühildumatute väljasätete kooskasutamist.

***

### Kohustuslikud väljad ja valideerimine

Kliendile kuvatava välja saab märkida kohustuslikuks. Kasutage kohustuslikke välju ainult siis, kui teave on vajalik tellimuse töötlemiseks või täitmiseks.

Täiendavatele väljadele saab rakendada ka toetatud valideerimisreegleid, näiteks:

* Minimaalne tähemärkide arv
* Maksimaalne tähemärkide arv

Valideerimine aitab hoida kogutud andmed ühtsena ja väldib puudulikke või vales formaadis väärtusi.

{% hint style="info" %}
Valideerimisreeglid kehtivad ainult uutele kliendisisestustele. Need ei muuda ajaloolistes tehingutes salvestatud väärtusi.
{% endhint %}

***

### Mitmekeelsed sildid

Kliendile kuvatavad täiendavad väljad toetavad mitmekeelseid kuvasilte.

Kasutage lühikest ja selget silti, mis selgitab täpselt, mida klient peab sisestama. Lisage asjakohased silditõlked, et väli jääks arusaadavaks ka siis, kui hostitud kassavaade kuvatakse teises toetatud keeles.

Näiteks:

<table><thead><tr><th width="176">Keel</th><th>Silt</th></tr></thead><tbody><tr><td>Inglise</td><td>Broneeringu viide</td></tr><tr><td>Eesti</td><td>Broneeringu viide</td></tr><tr><td>Läti</td><td>Broneeringu viide</td></tr><tr><td>Leedu</td><td>Broneeringu number</td></tr></tbody></table>

Ülaltoodud näited illustreerivad, kuidas mitmekeelsed sildid võivad olla üles ehitatud; tegelik sõnastus jääb teie vastutusele.

{% hint style="info" %}
Vältige sisemise terminoloogia kasutamist, millest kliendid ei pruugi aru saada. Näiteks eelistage **Broneeringu viide** sisemisele lühendile nagu **BKG\_REF**.
{% endhint %}

***

### Levinud kasutusjuhtumid

Täiendavad väljad võivad toetada erinevaid operatiivseid ja lepitamisvajadusi.

#### Seostage makse sisemise kirjega

Eeltäitke makselingi loomisel sisemine tellimuse, konto, broneeringu või lepingu viide. Viide salvestatakse koos tehinguga ja aitab teie meeskondadel makse õige ärikirjega seostada.

#### Koguge täitmisega seotud teavet

Paluge kliendilt teavet, mida on vaja ostu lõpuleviimiseks, näiteks osaleja nimi, soovitud tarnejuhis või teenuse viide.

#### Toetage erinevaid makselingi kasutusstsenaariume

Seostage erinevad väljad erinevate makselinkidega. Näiteks sündmuse makse võib küsida osaleja nime, samas kui teenuse makse võib sisaldada müüja sisestatud lepingu viidet.

{% hint style="info" %}
Koguge ainult seda teavet, mis on makse eesmärgiga otseselt seotud.
{% endhint %}

***

### Välja muudatuste haldamine

Täiendava välja muudatused rakenduvad edasiulatuvalt.

Sildi, valideerimisreegli või muu välja definitsiooni uuendamine mõjutab selle edasist kasutust, kuid ei muuda ajaloolisi tehingukirjeid. Varem kogutud väärtused jäävad seotuks nende tehingutega, mille all need esitati.

Enne juba kasutusel oleva välja muutmist kaaluge, kas:

* Olemasolevad makselingid kasutavad seda välja.
* Uuendatud sildil on endiselt sama tähendus.
* Valideerimisreeglid jäävad oodatavate väärtustega ühilduvaks.
* Teie operatiivsed või lepitamisprotsessid sõltuvad eelmisest konfiguratsioonist.

Looge eraldi väli olemasoleva ümberkasutamise asemel, kui uuel väljal on oluliselt erinev tähendus.

***

### Andmekaitse ja turvalisus

{% hint style="warning" %}
**Ärge kasutage täiendavaid välju makseandmete või tundlike autentimisandmete kogumiseks.**

Ärge kunagi küsige kohandatud välja kaudu kaardinumbreid, CVV/CVC koode, PIN-koode, paroole ega internetipanga sisselogimisandmeid.
{% endhint %}

Koguge ainult konkreetse makse jaoks vajalikku teavet ja selgitage selgelt, miks seda vaja on. See järgib GDPR-i põhimõtet, et isikuandmed peavad olema asjakohased ja piirduma vajalikuga. Juhtivad makseplatvormid rakendavad sama ettevaatlikkust kohandatud kassaväljade puhul, samas kui PCI DSS keelab kaardi verifitseerimiskoodide säilitamise pärast autoriseerimist.

Teie vastutate järgmise eest:

* Määrake, millist teavet tuleks koguda.
* Tagage asjakohane õiguslik alus, kui väli sisaldab isikuandmeid.
* Esitage selged ja täpsed väljasildid.
* Kogutud teabe asjakohane kaitsmine ja kasutamine.
* Vältige konfidentsiaalse või tundliku teabe tarbetut kogumist.
* Veenduge, et välja sisu vastaks kehtivatele seadustele ja teie privaatsuspoliitikale.

***

### Kaupmehe parimad tavad

* **Hoidke sildid selged.** Rääkige kliendile täpselt, millist väärtust oodatakse.
* **Koguge ainult seda, mida vajate.** Iga lisaväli suurendab kassas tehtavat pingutust.
* **Kasutage kohustuslikke välju valikuliselt.** Ärge blokeerige makset teabe tõttu, mida saab koguda hiljem.
* **Rakendage mõistlikku valideerimist.** Määrake piirangud, mis lükkavad tagasi vigased sisendid, takistamata seejuures õiguspäraseid väärtusi.
* **Kasutage müüja sisestatud välju sisemiste viidete jaoks.** Ärge paluge klientidel sisestada teavet, mis on teie süsteemidele juba teada.
* **Kasutage järjepidevat välja tähendust.** Ärge kasutage üht välja uuesti mitteseotud eesmärkidel.
* **Vaadake tõlked üle.** Veenduge, et igal sildil oleks igas toetatud keeles sama tähendus.
* **Testige kliendikogemust.** Kontrollige, et väljad kuvatakse õigesti ja et neid on lihtne täita nii lauaarvutis kui ka mobiilseadmes.

***

### Korduma kippuvad küsimused

<details>

<summary>Mis on täiendav väli?</summary>

Täiendav väli on lisanduv kaupmehe määratletud andmeväli, mis on seotud makselingiga. See võib sisaldada teie sisestatud väärtust või küsida kassas kliendilt teavet.

</details>

<details>

<summary>Kas ma saan makselingile lisada rohkem kui ühe täiendava välja?</summary>

Jah. Ühe makselingiga võib seostada ühe või mitu täiendavat välja, sõltuvalt Teenuses saadaolevatest piirangutest ja konfiguratsioonist.

</details>

<details>

<summary>Kas ma saan väärtuse ise sisestada?</summary>

Jah. Väärtuse saab makselingi loomisel eeltäita. Seejärel salvestatakse väärtus tehingu metaandmetena.

</details>

<details>

<summary>Kas täiendav väli saab olla kohustuslik?</summary>

Jah. Kliendile kuvatavad väljad saab märkida kohustuslikuks.

</details>

<details>

<summary>Kas ma saan kliendi sisestatud teavet valideerida?</summary>

Jah. Toetatud valideerimisreeglite hulka kuuluvad minimaalne ja maksimaalne tähemärkide arv. Täpsed saadaolevad valikud sõltuvad Teenuse poolt toetatud välja konfiguratsioonist.

</details>

<details>

<summary>Kas väljasilte saab tõlkida?</summary>

Jah. Täiendavad väljad toetavad kliendile kuvatavate väljade mitmekeelseid silte.

</details>

<details>

<summary>Mis juhtub, kui ma välja muudan?</summary>

Muutus rakendub edaspidisele kasutusele. Ajaloolisi tehingukirjeid ja varem kogutud väärtusi ei muudeta.

</details>

<details>

<summary>Kas ma saan täiendavaid välju kasutada kaardiandmete kogumiseks?</summary>

Ei. Makseandmeid ja tundlikke autentimisandmeid tohib koguda ainult selleks ettenähtud turvaliste maksekomponentide kaudu. Ärge kunagi kasutage täiendavaid välju kaardinumbri, CVV/CVC koodide, PIN-koodide, paroolide ega pangandusandmete jaoks.

</details>

### Seotud dokumentatsioon

*
* [Makselingid ja QR-koodid](/seb-docs-draft/seb-docs-public-et/omadused/makselingid-ja-qr-koodid.md)
* [Hostitud Checkout](/seb-docs-draft/seb-docs-public-et/integratsioon/majutatud-kassavaade.md)
* [Makseviisid](/seb-docs-draft/seb-docs-public-et/makseviisid/kaardid.md)
* Kaardid [Makseolekud](/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)
* [Merchant Portal](/seb-docs-draft/seb-docs-public-et/juhendid/kaupmehe-portaal.md)
* [Tellimused](/seb-docs-draft/seb-docs-public-et/juhendid/kaupmehe-portaal/jalgige-oma-ari/tellimused.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/omadused/taiendavad-valjad.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.