> 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-lt/funkcijos/papildomi-laukai.md).

# Papildomi laukai

Surinkite papildomą informaciją, kurios jūsų verslui reikia, kai klientai atsiskaito per mokėjimo nuorodas.

Papildomi laukai leidžia į mokėjimo užklausą pridėti prekybininkui skirtos informacijos nekeičiant standartinio mokėjimo srauto. Naudokite juos, kad prie operacijos pridėtumėte savo nuorodinius duomenis arba paprašytumėte kliento papildomos informacijos priglobto atsiskaitymo metu.

Pavyzdžiui, papildomus laukus galite naudoti užsakymo nuorodai, užsakymo numeriui, dalyvio vardui, pristatymo instrukcijai ar kitai išsamiai informacijai, reikalingai pirkimui apdoroti.

{% hint style="info" %}
Prieinamumas ir valdymo teisės priklauso nuo jūsų prekybininko konfigūracijos ir „Merchant Portal“ naudotojui priskirtų leidimų.
{% endhint %}

### Galimybių santrauka

<table><thead><tr><th width="260">Galimybė</th><th>Palaikymas</th></tr></thead><tbody><tr><td>Laukų valdymas</td><td>Kurti, aktyvinti ir valdyti papildomus laukus </td></tr><tr><td>Mokėjimo nuorodos susiejimas</td><td>Prie mokėjimo nuorodos pridėti vieną ar kelis laukus</td></tr><tr><td>Prekybininko pateikiamos reikšmės</td><td>Iš anksto užpildyti lauką kuriant mokėjimo nuorodą</td></tr><tr><td>Kliento pateikiamos reikšmės</td><td>Paprašyti kliento įvesti reikšmę atsiskaitymo metu</td></tr><tr><td>Privalomi laukai</td><td>Pažymėti lauką kaip privalomą</td></tr><tr><td>Validavimas</td><td>Konfigūruokite palaikomas taisykles, pvz., minimalų ir maksimalų ilgį</td></tr><tr><td>Klientui rodomos etiketės</td><td>Konfigūruokite daugiakalbes laukų etiketes</td></tr><tr><td>Rodymas atsiskaitymo metu</td><td>Laukai pateikiami priglobtame atsiskaitymo lange</td></tr><tr><td>Operacijos duomenys</td><td>Prekybininko pateiktas reikšmes saugoti kaip operacijos metaduomenis</td></tr><tr><td>Istoriniai įrašai</td><td>Vėlesni laukų pakeitimai nepakeičia esamų operacijų</td></tr></tbody></table>

***

### Kaip veikia papildomi laukai

Papildomas laukas apibrėžiamas atskirai, o tada susiejamas su mokėjimo nuoroda.

Įprastas procesas yra toks:

1. [**Sukurkite lauką**](/seb-docs-draft/seb-docs-public-lt/gaires/prekybininko-portalas/priimkite-mokejimus-be-integracijos/mokejimo-nuorodos-ir-qr-kodai.md)**.** Nustatykite papildomą informaciją, kurią norite surinkti arba pridėti prie mokėjimo.
2. **Nustatykite etiketę.** Įveskite klientui rodomą lauko etiketę, prireikus įskaitant ir daugiakalbes versijas.
3. **Aktyvinkite lauką.** Su naujomis mokėjimo nuorodomis galima naudoti tik aktyvius laukus.
4. **Pridėkite jį prie** [**mokėjimo nuorodos.**](/seb-docs-draft/seb-docs-public-lt/gaires/prekybininko-portalas/priimkite-mokejimus-be-integracijos/mokejimo-nuorodos-ir-qr-kodai.md) Kurdami nuorodą pasirinkite vieną ar kelis papildomus laukus.
5. **Pasirinkite lauko elgseną.** Patys iš anksto įveskite reikšmę arba paprašykite kliento ją pateikti atsiskaitymo metu.
6. **Surinkite mokėjimą.** Sukonfigūruotas laukas rodomas priglobtame atsiskaityme, o reikšmė susiejama su atitinkama operacija.

{% hint style="info" %}
Papildomi laukai papildo standartinę mokėjimo informaciją. Jie nekeičia mokėjimo sumos, mokėjimo metodų, autentifikavimo proceso ar kitų mokėjimo apdorojimo taisyklių.
{% endhint %}

***

### Lauko elgsena

Nustatykite, kaip kiekvienas papildomas laukas elgiasi to mokėjimo nuorodos, prie kurios jis prijungtas, atžvilgiu.

| Lauko elgsena                   | Kaip tai veikia                                                                               | Pavyzdys                                                      |
| ------------------------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| Prekybininko pateikiama reikšmė | Reikšmę įvedate kurdami mokėjimo nuorodą. Reikšmė saugoma kaip operacijos metaduomenys.       | Vidinis užsakymo numeris, sutarties nuoroda, kampanijos kodas |
| Kliento pateikiama reikšmė      | Laukas rodomas priglobtame atsiskaityme, o klientas reikšmę įveda prieš užbaigdamas mokėjimą. | Dalyvio vardas, pristatymo instrukcija, rezervacijos nuoroda  |

Galima elgsena kiekvienai lauko ir nuorodos sąsajai konfigūruojama atskirai.

Sistema patikrina konfigūraciją ir neleidžia kartu naudoti logiškai nesuderinamų lauko nustatymų.

***

### Privalomi laukai ir validavimas

Klientui rodomas laukas gali būti pažymėtas kaip privalomas. Privalomus laukus naudokite tik tada, kai informacija būtina užsakymui apdoroti arba įvykdyti.

Papildomiems laukams taip pat gali būti taikomos palaikomos validavimo taisyklės, pvz.:

* Minimalus simbolių ilgis
* Maksimalus simbolių ilgis

Validavimas padeda užtikrinti surinktų duomenų nuoseklumą ir neleidžia pateikti nepilnų arba neteisingo formato reikšmių.

{% hint style="info" %}
Validavimo taisyklės taikomos tik naujai kliento įvedamai informacijai. Jos nekeičia istoriniuose operacijų įrašuose saugomų reikšmių.
{% endhint %}

***

### Daugiakalbės etiketės

Klientui rodomi papildomi laukai palaiko daugiakalbes rodomąsias etiketes.

Naudokite trumpą ir aiškią etiketę, kuri tiksliai paaiškina, ką klientas turi įvesti. Pateikite reikiamus etikečių vertimus, kad laukas išliktų suprantamas, kai priglobtas atsiskaitymas rodomas kita palaikoma kalba.

Pavyzdžiui:

<table><thead><tr><th width="176">Kalba</th><th>Etiketė</th></tr></thead><tbody><tr><td>Anglų</td><td>Rezervacijos nuoroda</td></tr><tr><td>Estų</td><td>Rezervacijos nuoroda</td></tr><tr><td>Latvių</td><td>Rezervacijos nuoroda</td></tr><tr><td>Lietuvių</td><td>Rezervacijos numeris</td></tr></tbody></table>

Pirmiau pateikti pavyzdžiai iliustruoja, kaip gali būti struktūruojamos daugiakalbės etiketės; už tikslų formuluotės turinį atsakote jūs.

{% hint style="info" %}
Venkite naudoti vidinę terminiją, kurios klientai gali nesuprasti. Pavyzdžiui, vietoj **Rezervacijos nuoroda** rinkitės **BKG\_REF**.
{% endhint %}

***

### Dažniausi naudojimo atvejai

Papildomi laukai gali patenkinti įvairius veiklos ir suderinimo poreikius.

#### Susiekite mokėjimą su vidiniu įrašu

Kurdami mokėjimo nuorodą iš anksto įveskite vidinę užsakymo, paskyros, rezervacijos arba sutarties nuorodą. Nuoroda saugoma kartu su operacija ir gali padėti jūsų komandoms susieti mokėjimą su teisingu verslo įrašu.

#### Rinkite įvykdymo informaciją

Paprašykite kliento pateikti informaciją, reikalingą pirkimui užbaigti, pvz., dalyvio vardą, pageidaujamą pristatymo instrukciją arba paslaugos nuorodą.

#### Palaikykite skirtingus mokėjimo nuorodų scenarijus

Prie skirtingų mokėjimo nuorodų pridėkite skirtingus laukus. Pavyzdžiui, renginio mokėjime gali būti prašoma dalyvio vardo, o paslaugos mokėjime gali būti pateikta prekybininko nurodyta sutarties nuoroda.

{% hint style="info" %}
Rinkite tik tą informaciją, kuri tiesiogiai susijusi su mokėjimo paskirtimi.
{% endhint %}

***

### Laukų pakeitimų valdymas

Papildomo lauko pakeitimai taikomi į ateitį.

Atnaujinus etiketę, validavimo taisyklę ar kitą lauko apibrėžtį, pokytis turi įtakos būsimam naudojimui, bet nepakeičia istorinių operacijų įrašų. Anksčiau surinktos reikšmės lieka susietos su tomis operacijomis, kuriomis jos buvo pateiktos.

Prieš keisdami jau naudojamą lauką, apsvarstykite, ar:

* Esamose mokėjimo nuorodose naudojamas šis laukas.
* Atnaujintos etiketės reikšmė išlieka tokia pati.
* Validavimo taisyklės išlieka suderinamos su numatomomis reikšmėmis.
* Jūsų veiklos arba suderinimo procesai priklauso nuo ankstesnės konfigūracijos.

Kai naujas laukas iš esmės turi kitokią reikšmę, sukurkite atskirą lauką, o ne keiskite esamo paskirtį.

***

### Duomenų apsauga ir saugumas

{% hint style="warning" %}
**Nenaudokite papildomų laukų mokėjimo prisijungimo duomenims ar jautriems autentifikavimo duomenims rinkti.**

Niekada neprašykite kortelės numerių, CVV/CVC kodų, PIN kodų, slaptažodžių ar internetinės bankininkystės prisijungimo duomenų per pasirinktinį lauką.
{% endhint %}

Rinkite tik konkrečiam mokėjimui būtiną informaciją ir aiškiai paaiškinkite, kodėl ji reikalinga. Tai atitinka BDAR principą, kad asmens duomenys turi būti tinkami ir apriboti iki to, kas būtina. Pagrindinės mokėjimų platformos taiko tą patį atsargumą pasirinkiniams atsiskaitymo laukams, o PCI DSS draudžia po autorizavimo saugoti kortelės patvirtinimo kodus.

Jūs atsakote už:

* Nustatymą, kokia informacija turi būti renkama.
* Tinkamo teisinio pagrindo turėjimą, kai lauke yra asmens duomenų.
* Aiškių ir tikslių laukų etikečių pateikimą.
* Surinktos informacijos tinkamą apsaugą ir naudojimą.
* Nereikalingo konfidencialios ar jautrios informacijos rinkimo vengimą.
* Lauko turinys atitinka taikomus teisės aktus ir jūsų privatumo politiką.

***

### Geriausia prekybininkų praktika

* **Palikite etiketes aiškias.** Tiksliai nurodykite klientui, kokios reikšmės tikimasi.
* **Rinkite tik tai, ko reikia.** Kiekvienas papildomas laukas didina atsiskaitymo pastangas.
* **Privalomus laukus naudokite pasirinktinai.** Neužblokuokite mokėjimo dėl informacijos, kurią galima surinkti vėliau.
* **Taikykite pagrįstą validavimą.** Nustatykite ribas, kurios atmestų netinkamą įvestį, bet neužkirstų kelio teisėtoms reikšmėms.
* **Vidinėms nuorodoms naudokite prekybininko pateikiamus laukus.** Neprašykite klientų įvesti informacijos, kurią jūsų sistemos jau žino.
* **Naudokite nuoseklias laukų reikšmes.** Vieno lauko nenaudokite nesusijusiems tikslams.
* **Peržiūrėkite vertimus.** Įsitikinkite, kad kiekviena etiketė visomis palaikomomis kalbomis reiškia tą patį.
* **Patikrinkite kliento patirtį.** Patikrinkite, ar laukai rodomi teisingai ir ar juos lengva užpildyti tiek staliniuose, tiek mobiliuosiuose įrenginiuose.

***

### Dažniausiai užduodami klausimai

<details>

<summary>Kas yra papildomas laukas?</summary>

Papildomas laukas yra papildomas prekybininko apibrėžtas duomenų laukas, susietas su mokėjimo nuoroda. Jame gali būti jūsų pateikta reikšmė arba galima paprašyti kliento informacijos atsiskaitymo metu.

</details>

<details>

<summary>Ar galiu prie mokėjimo nuorodos pridėti daugiau nei vieną papildomą lauką?</summary>

Taip. Prie mokėjimo nuorodos galima susieti vieną ar kelis papildomus laukus, atsižvelgiant į platformoje galiojančius limitus ir konfigūraciją.

</details>

<details>

<summary>Ar galiu reikšmę įvesti pats?</summary>

Taip. Reikšmę galima iš anksto įvesti kuriant mokėjimo nuorodą. Tuomet reikšmė saugoma kaip operacijos metaduomenys.

</details>

<details>

<summary>Ar papildomas laukas gali būti privalomas?</summary>

Taip. Klientui rodomi laukai gali būti pažymėti kaip privalomi.

</details>

<details>

<summary>Ar galiu patvirtinti kliento įvestą informaciją?</summary>

Taip. Palaikomos validavimo taisyklės apima minimalų ir maksimalų simbolių ilgį. Tikslios galimos parinktys priklauso nuo platformoje palaikomos lauko konfigūracijos.

</details>

<details>

<summary>Ar laukų etiketės gali būti išverstos?</summary>

Taip. Papildomi laukai palaiko daugiakalbes klientui rodomų laukų etiketes.

</details>

<details>

<summary>Kas nutinka, jei pakeičiu lauką?</summary>

Pakeitimas taikomas būsimam naudojimui. Istoriniai operacijų įrašai ir anksčiau surinktos reikšmės nekeičiasi.

</details>

<details>

<summary>Ar galiu naudoti papildomus laukus kortelės duomenims rinkti?</summary>

Ne. Mokėjimo prisijungimo duomenys ir jautrūs autentifikavimo duomenys turi būti renkami tik per tam skirtus saugius mokėjimo komponentus. Niekada nenaudokite papildomų laukų kortelės numeriams, CVV/CVC kodams, PIN kodams, slaptažodžiams ar bankininkystės prisijungimo duomenims.

</details>

### Susijusi dokumentacija

*
* [Mokėjimo nuorodos ir QR kodai](/seb-docs-draft/seb-docs-public-lt/funkcijos/mokejimo-nuorodos-ir-qr-kodai.md)
* [Priglobtas atsiskaitymas](/seb-docs-draft/seb-docs-public-lt/integracija/talpinamas-atsiskaitymas.md)
* [Mokėjimo būdai](/seb-docs-draft/seb-docs-public-lt/mokejimo-metodai/korteles.md)
* Kortelės [Mokėjimo būsenos](/seb-docs-draft/seb-docs-public-lt/mokejimo-metodai/korteles/mokejimo-busenos.md)
* Pay by Bank [Mokėjimo būsenos](/seb-docs-draft/seb-docs-public-lt/mokejimo-metodai/mokekite-is-banko/mokejimo-busenos.md)
* [Merchant Portal](/seb-docs-draft/seb-docs-public-lt/gaires/prekybininko-portalas.md)
* [Užsakymai](/seb-docs-draft/seb-docs-public-lt/gaires/prekybininko-portalas/stebekite-savo-versla/uzsakymai.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-lt/funkcijos/papildomi-laukai.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.