# Doporučení pro UI/UX (/cs/in-store/integration/ui_ux_recommendations)



Integrace platebního řešení není jen o technické implementaci; jde o vytvoření uživatelského zážitku, který působí bezpečně, profesionálně a snadno se používá. Níže najdete doporučení, jak navrhnout průběh vaší aplikace okolo Tapaya Accept SDK.

## Spuštění platby [#triggering-the-payment]

### Jasná výzva k akci (CTA) [#clear-call-to-action-cta]

Zajistěte, aby tlačítko pro zahájení platby bylo výrazné a mělo jasný popisek.

* **Dobře:** „Zaplatit 12,50 €“, „Zaplatit kartou“, „K platbě“
* **Špatně:** „Odeslat“, „Další“, „OK“

### Zpětná vazba na interakci [#feedback-on-interaction]

Když uživatel klepne na platební tlačítko, poskytněte okamžitou vizuální zpětnou vazbu (např. indikátor načítání nebo deaktivovaný stav), abyste zabránili dvojitému klepnutí, zatímco se SDK inicializuje.

## Během transakce [#during-the-transaction]

Tapaya Accept SDK obsluhuje citlivé části transakce (čtení karty, zadání PINu) vlastním překryvným rozhraním. Za kontext před transakcí a po ní však odpovídá vaše aplikace.

### Nezakrývejte obrazovku [#do-not-obscure-the-screen]

SDK potřebuje celou obrazovku, aby zajistilo bezpečnost a zabránilo útokům pomocí překryvných vrstev. Nepokoušejte se přes platební rozhraní vykreslovat plovoucí okna ani chatovací bubliny, protože to může spustit bezpečnostní mechanismy, které transakci přeruší.

### Navádění k umístění NFC [#nfc-positioning-guidance]

Bezkontaktní čtení karet závisí na NFC anténě zařízení, jejíž umístění se liší podle modelu zařízení.

* **Doporučení:** Pokud je to možné, zobrazte ve své aplikaci *před* voláním SDK krátkou animaci nebo nápovědu, která uživateli ukáže, kde se na jeho konkrétním zařízení nachází NFC čip (obvykle vzadu nahoře nebo uprostřed).

## Zpracování výsledků [#handling-results]

### Stav při úspěchu [#success-state]

* **Vizuální potvrzení:** Zobrazte jasnou obrazovku „Úspěch“ se zeleným zatržítkem nebo podobným pozitivním prvkem.
* **Účtenky:** Nabídněte okamžitou možnost odeslat digitální účtenku (e-mail/SMS) nebo ji vytisknout, pokud je připojena tiskárna.

### Stav při selhání [#failure-state]

* **Srozumitelné chybové zprávy:** Pokud transakce selže, převeďte technické chybové kódy do jazyka srozumitelného uživateli.
  * *Technický kód:* `DECLINED_INSUFFICIENT_FUNDS`
  * *Pro uživatele:* „Transakce byla zamítnuta. Zkontrolujte prosím zůstatek nebo zkuste jinou kartu.“
* **Možnost opakování:** Nabídněte výrazné tlačítko „Zkusit znovu“, aby obchodník mohl proces rychle spustit znovu bez opětovného zadávání částky.

## Aplikace Tapaya Terminal [#tapaya-terminal-app]

Aplikace Tapaya Terminal umožňuje obchodníkům přijímat platby kartou samostatně. Integrátoři si mohou prostředí pro obchodníky v aplikaci Tapaya Terminal přizpůsobit; pro začátek kontaktujte [developers@tapaya.com](mailto:developers@tapaya.com).

### Přizpůsobení UI [#ui-customization]

UI aplikace Tapaya Terminal můžete změnit v Tapaya Platform v části **Settings > Application > App Theme**, nebo programově přes [Platform API](/platform-api). Barvy a prvky značky (logo, slovní loga) se v celé aplikaci Tapaya Terminal uplatní jednotně.

## Přístupnost [#accessibility]

* **Zvuk:** SDK přehrává zvukové signály při čtení karty a při chybách. Zajistěte, aby vaše aplikace během platby neztlumila systémovou hlasitost ani nezasahovala do zvukového fokusu.
* **Haptika:** SDK potvrzuje čtení karty vibracemi. To je zásadní pro přístupnost i pro obecnou zpětnou vazbu v hlučném prostředí.
