> Source: https://fiscal.link/payment-terminals/docs/setup
> Adaugi și testezi terminalul de card în aplicația FiscalLink: banca și protocolul, conexiunea serial sau rețea, terminalul implicit și mesajele de eroare.

# Configurarea terminalelor în aplicație

Adaugă terminalul bancar în aplicația FiscalLink și verifică legătura. După configurare, programul tău de vânzare poate trimite cereri de plată către terminal.

Urmează să apară

Terminalele bancare vin într-o versiune viitoare a aplicației FiscalLink. Ghidul arată cum vor funcționa; în versiunea pe care o descarci acum, fila Terminale de plată nu există încă.

## Ce îți trebuie

-   **Aplicația FiscalLink, cu o casă de marcat conectată.** → [Conectarea casei de marcat](https://fiscal.link/app/docs/cash-registers)
-   **O licență pe casa de marcat**, Essential sau Commerce. Terminalele nu au licență proprie și nu costă nimic în plus. → [Activarea licenței](https://fiscal.link/app/docs/licence)
-   **Un terminal de card de la una dintre băncile din listă**, cu legătura către casa de marcat (modul ECR) pornită. Dacă nu știi dacă e pornită, întreabă banca.
-   **Legătura cu terminalul:** un cablu serial sau USB până la calculatorul sau telefonul cu aplicația, ori aceeași rețea, pentru terminalele care merg în rețea.
-   **Programul tău de vânzare**, care cere plata prin API-ul local al aplicației. Aplicația nu încasează singură.

Terminalele se configurează în aplicație, în **Configurare** → fila **Terminale de plată**.

## Platforme și conexiuni

| Platformă | Serial / USB | Rețea |
| --- | --- | --- |
| Windows, macOS, Linux | Da: port serial sau port COM virtual prin USB | Da, pentru GPE și Printec |
| Android | Da, prin portul USB al dispozitivului | Da, pentru GPE și Printec |
| iOS | Nu | Da, pentru GPE și Printec |

Aplicația îți oferă doar combinațiile pe care le poate folosi pe dispozitivul tău. Dacă alegi un protocol cu o conexiune pe care nu o poate folosi, îți spune înainte să salvezi.

## Bănci și protocoale

În aplicație alegi întâi banca, apoi protocolul terminalului. Fiecare bancă are protocoalele ei:

| Banca | Protocolul din aplicație | Conexiune | Viteza implicită (baud) |
| --- | --- | --- | --- |
| UniCredit | Ingenico - Ingenio (Unicredit) | Serial / USB | 9600 |
| Banca Transilvania | SmartPay (Ingenico) | Serial / USB | 115200 |
| BCR | GPE (Global Payments) | Serial / USB sau Rețea | 9600 |
| ING Bank | Mellon | Serial / USB | 9600 |
| ING Bank | Payten | Serial / USB | 9600 |
| ING Bank | ePay (Avera) | Serial / USB | 115200 |
| Raiffeisen Bank | Verifone - Printec sau Verifone - PrintecDLL | Serial / USB sau Rețea | 9600 |
| Raiffeisen Bank | Newland - FIP11 | Serial / USB | 9600 |
| BRD | Payten | Serial / USB | 9600 |

-   **Verifone - Printec** și **Verifone - PrintecDLL** folosesc același protocol. Poți alege oricare dintre cele două opțiuni din meniu.
-   Viteza trebuie să fie aceeași ca în setarea ECR a terminalului. Aplicația completează viteza implicită a protocolului; o schimbi doar dacă terminalul tău e setat altfel.
-   Restul setărilor liniei seriale le alege aplicația după protocol. Nu ai nimic de setat.
-   Banca ta nu e în listă sau terminalul folosește alt protocol? [Scrie-ne](https://fiscal.link/contact).

## Adaugi un terminal

1.  În aplicația FiscalLink, deschide **Configurare** → fila **Terminale de plată** și apasă **Adaugă terminal**.
2.  La **Bancă**, alege banca terminalului. La **Protocol** apar doar protocoalele ei.
3.  La **Conexiune**, alege **Serial / USB** sau **Rețea**.
4.  Pentru **Serial / USB**, alege **Port**\-ul la care e legat terminalul și verifică **Viteză (baud)**. Lista arată doar porturile libere: portul casei de marcat și porturile celorlalte terminale nu apar. Dacă ai legat terminalul după ce ai deschis formularul, apasă **Actualizează**.
5.  Pentru **Rețea**, scrie **Adresă IP** (sau numele de rețea al terminalului) și **Port TCP**. Dacă lași portul gol, aplicația folosește 2050, portul GPE; pentru Printec scrie portul setat pe terminal.
6.  Opțional, completează **Nume**, de cel mult 64 de caractere, de exemplu „Casa 1”. Fără nume, în listă apare seria terminalului.
7.  Apasă **Salvează și conectează**. Aplicația salvează terminalul și se conectează la el.

După salvare, aplicația îți arată unul dintre aceste mesaje:

-   **Terminal conectat**, cu seria terminalului și, când o raportează, versiunea lui de software. Terminalul e gata.
-   **Salvat, dar terminalul nu a răspuns**: terminalul e salvat, iar aplicația reîncearcă singură în fundal. Vezi [Mesaje de eroare](#mesaje-de-eroare).
-   **Terminal salvat**: casa de marcat s-a deconectat între timp. Terminalul se conectează imediat ce casa e conectată din nou.

Un terminal primește plăți abia după ce și-a raportat seria. În listă, fiecare terminal apare cu numele sau seria, protocolul, portul ori adresa și starea: **Conectat** sau **Neconectat**.

## Testezi terminalul

Apasă **Testează** pentru a verifica informațiile terminalului. Pentru protocoalele care permit identificarea, aplicația contactează terminalul și verifică seria. Pentru celelalte, testul arată doar portul configurat. Primești **Terminal conectat** sau **Testul a eșuat**, împreună cu motivul.

### Plata de test

**Plată 0.10 RON** face o plată de probă pe terminal: terminalul cere cardul, iar la final vezi **Plată de test aprobată**, cu codul de autorizare, sau **Plată de test respinsă**, cu motivul dat de terminal.

**Plata de test e o vânzare reală de 0,10 lei.** Suma se încasează de pe card. Aplicația nu o anulează singură și nu o trece printre plățile programului tău de vânzare.

## Terminalul implicit

Cu mai multe terminale, apasă **Setează implicit** la cel pe care îl folosești cel mai des; în listă apare marcat **Implicit**. Programul tău de vânzare vede care terminal e implicit, dar fiecare plată numește terminalul pe care se face. Butonul apare doar la un terminal care și-a raportat seria. Dacă elimini terminalul implicit, niciun terminal nu mai e implicit.

## Modifici sau elimini un terminal

**Modifică** redeschide formularul cu banca, protocolul și conexiunea terminalului. Schimbi ce trebuie și apeși **Salvează și conectează**. Aplicația verifică apoi că la noul port sau la noua adresă e același terminal. Dacă găsește altul, îți cere să-l elimini pe cel vechi și să-l adaugi pe cel nou.

**Elimină** îți cere confirmarea: terminalul nu mai primește plăți cu cardul prin FiscalLink, iar istoricul tranzacțiilor lui rămâne pe dispozitiv. Poți elimina un terminal și fără casă de marcat conectată, de exemplu unul care nu mai există. Nu îl poți elimina cât timp are plăți neconfirmate.

## Fără casă de marcat conectată

-   Terminalele funcționează doar cât timp o casă de marcat e conectată în aplicație. Fără ea, nu poți adăuga, modifica sau testa un terminal, iar plățile cu cardul sunt refuzate.
-   Când casa se deconectează, se deconectează și terminalele. O plată în curs nu e întreruptă: aplicația așteaptă să se termine.
-   Când casa se conectează din nou, aplicația reconectează singură fiecare terminal.
-   Cu o casă conectată, dar fără licență, poți adăuga și testa terminale. Plăți cu cardul primesc după ce activezi licența pe casă.

Cum conectezi casa: [Conectarea casei de marcat](https://fiscal.link/app/docs/cash-registers). Cum activezi licența: [Activarea licenței](https://fiscal.link/app/docs/licence).

## Plata din programul tău

Aplicația nu are un ecran de încasare. Programul tău de vânzare cere plata prin API-ul local al aplicației FiscalLink, aplicația o trimite la terminalul ales, iar programul primește rezultatul: aprobată sau refuzată. Pentru cine scrie programul: [API pentru integratori](https://fiscal.link/payment-terminals/docs/api).

Plata prin terminal nu se cere din FiscalLink Cloud sau din Shopify POS.

## Plăți neconfirmate

Dacă se întrerupe conexiunea în timpul plății, terminalul poate să nu confirme rezultatul. Suma poate fi deja încasată. În lista terminalelor apare mesajul: „O plată cu cardul este încă verificată cu terminalul. Nu încasați din nou acel card.”

-   Nu încasa din nou cardul. Verifică pe ecranul sau pe bonul terminalului dacă plata a trecut.
-   Aplicația încearcă să clarifice plata cu terminalul când acesta se reconectează, apoi periodic.
-   Până se clarifică, terminalul nu primește plăți noi și nu poate fi eliminat.

## Mesaje de eroare

Mai jos găsești mesajele afișate de aplicație și pașii recomandați. Valorile dintre paranteze drepte sunt completate automat, de exemplu portul, seria sau motivul erorii.

### În fila Terminale de plată

| Mesajul | Ce faci |
| --- | --- |
| Necesită o casă de marcat conectată. Fără ea, terminalele nu pot fi adăugate, modificate, testate sau folosite. | Conectează casa de marcat în aplicație. → [Conectarea casei de marcat](https://fiscal.link/app/docs/cash-registers) |
| Plățile cu cardul au nevoie de o casă de marcat licențiată. Terminalele pot fi adăugate și testate acum; încasează plăți după ce casa este licențiată. | Activează licența pe casă. → [Activarea licenței](https://fiscal.link/app/docs/licence) |
| Niciun port serial liber. Conectați terminalul, apoi reîmprospătați. | Leagă terminalul, apoi apasă **Actualizează**. Portul casei de marcat și porturile celorlalte terminale nu apar în listă. |
| Terminalele \[protocol\] cu conexiunea „\[conexiune\]” nu sunt suportate în această versiune. | Alege o conexiune pe care o are protocolul (vezi [Bănci și protocoale](#banci-si-protocoale)). Pe iOS merge doar **Rețea**. Dacă mesajul apare la GPE pe orice conexiune, versiunea ta nu poate lucra încă cu terminalele GPE: [scrie-ne](https://fiscal.link/contact). |
| \[port\] este deja folosit de casa de marcat sau de alt terminal de plată. | Alege alt port sau altă adresă. Un port sau o adresă servește un singur dispozitiv. |
| Alt terminal de plată are deja seria \[serie\]. | Terminalul e deja în listă, pe alt port sau la altă adresă. Modifică-l pe acela în loc să-l adaugi din nou. |
| Portul TCP trebuie să fie un număr între 1 și 65535. | Scrie portul ca număr sau lasă-l gol pentru 2050. |
| Introduceți adresa IP sau numele de rețea al terminalului. | Scrie adresa IP a terminalului (de exemplu 192.168.1.50) sau numele lui de rețea. |
| Numele poate avea cel mult 64 caractere. | Scurtează numele. |
| Salvat, dar terminalul nu a răspuns. Nu răspunde nimic pe \[port\]. Verificați că terminalul este pornit și în modul ECR (un terminal Android se conectează prin Bluetooth ECR). | Pornește terminalul și întreabă banca dacă legătura cu casa de marcat (modul ECR) e pornită. Verifică portul ales și ca viteza să fie aceeași ca pe terminal. Aplicația reîncearcă singură; apasă **Testează** ca să încerci imediat. |
| Comunicarea cu terminalul de plată de pe \[port\] a eșuat: \[motiv\] | Motivul poate fi: conexiunea nu este deschisă, conexiunea s-a închis, niciun răspuns în timpul de așteptare, trei răspunsuri invalide la rând, terminalul nu a confirmat cererea, terminalul nu și-a raportat seria. Verifică cablul sau rețeaua, viteza și protocolul ales, apoi apasă **Testează**. |
| Terminalul de pe \[port\] raportează seria \[serie nouă\], nu \[serie veche\]. Ștergeți-l și adăugați-l pe cel nou. | La port e alt terminal decât cel salvat. Elimină terminalul vechi din listă și adaugă-l pe cel nou. |
| Terminal ocupat. O plată rulează pe acest terminal. Încercați din nou după ce se termină. | Așteaptă să se termine plata, apoi încearcă din nou. |
| Terminalul de plată \[serie\] are încă tranzacții în verificare. Poate fi șters după ce se clarifică. | Vezi [Plăți neconfirmate](#plati-neconfirmate). Elimini terminalul după ce plățile se clarifică. |
| Terminalele de plată funcționează doar cât timp o casă de marcat este conectată. | Conectează din nou casa de marcat, apoi reia ce făceai. |
| Configurația terminalelor de plată nu a putut fi citită, așa că nu se modifică acum. Reporniți FiscalLink; dacă problema persistă, contactați suportul. | Repornește aplicația. Dacă mesajul rămâne, [scrie-ne](https://fiscal.link/contact). |
| Plată de test respinsă. \[motivul dat de terminal\] | Terminalul sau banca a refuzat plata. Încearcă alt card sau verifică terminalul cu banca. |

#### Primite de programul tău de vânzare

| Mesajul | Ce faci |
| --- | --- |
| Plata cu cardul a fost refuzată: \[motiv\] | Cardul a fost refuzat. Cere alt card sau altă metodă de plată. |
| Terminalul de plată \[serie\] nu a confirmat rezultatul tranzacției \[tranzacție\]. Se verifică; nu încasați din nou cardul. | Nu încasa din nou cardul. Vezi [Plăți neconfirmate](#plati-neconfirmate). |
| Terminalul de plată \[serie\] încă verifică o tranzacție anterioară (\[tranzacție\]). Încercați din nou după ce se clarifică. | Terminalul nu primește plăți noi până se clarifică plata anterioară. Între timp, folosește alt terminal sau altă metodă de plată. |
| Terminalul de plată \[serie\] este ocupat cu altă operațiune. Așteptați să se termine, apoi încercați din nou. | Așteaptă să se termine operația în curs, apoi încearcă din nou. |
| Terminalul de plată \[serie\] nu este conectat. Verificați cablul sau rețeaua, apoi încercați din nou. | Verifică cablul sau rețeaua și starea terminalului în fila **Terminale de plată**. |
| Terminalele de plată au nevoie de o casă de marcat conectată și licențiată. | Conectează casa de marcat și verifică licența ei. |
| Niciun terminal de plată cu seria \[serie\] nu este configurat în acest driver. | Programul cere un terminal care nu e în aplicație. Compară seria din fila **Terminale de plată** cu cea din setările programului. |
| Suma trebuie să fie mai mare decât zero, cu cel mult două zecimale. | Verifică suma trimisă de program. Dacă nu o poți corecta din setări, contactează furnizorul software. |