# Raccomandazioni UI/UX (/it/in-store/integration/ui_ux_recommendations) Integrare una soluzione di pagamento non è solo una questione di implementazione tecnica: si tratta di creare un'esperienza utente che trasmetta sicurezza e professionalità e che sia facile da usare. Di seguito trova alcune raccomandazioni per progettare il flusso dell'app attorno a Tapaya Accept SDK. ## Avvio del pagamento [#triggering-the-payment] ### Invito all'azione (CTA) chiaro [#clear-call-to-action-cta] Si assicuri che il pulsante per avviare il pagamento sia ben visibile e abbia un'etichetta chiara. * **Corretto:** “Paga 12,50 €”, “Addebita sulla carta”, “Vai al pagamento” * **Da evitare:** “Invia”, “Avanti”, “OK” ### Feedback sull'interazione [#feedback-on-interaction] Quando l'utente tocca il pulsante di pagamento, fornisca un feedback visivo immediato (ad es. un indicatore di caricamento o uno stato disabilitato) per evitare doppi tocchi mentre l'SDK si inizializza. ## Durante la transazione [#during-the-transaction] Tapaya Accept SDK gestisce le parti sensibili della transazione (lettura della carta, inserimento del PIN) con una propria interfaccia in sovrimpressione. Il contesto prima e dopo la transazione è però responsabilità della Sua app. ### Non coprire lo schermo [#do-not-obscure-the-screen] L'SDK richiede l'intero schermo per garantire la sicurezza e prevenire attacchi tramite overlay. Non tenti di disegnare finestre mobili o bolle di chat sopra l'interfaccia di pagamento, perché ciò potrebbe attivare meccanismi di sicurezza che interrompono la transazione. ### Indicazioni sulla posizione dell'NFC [#nfc-positioning-guidance] La lettura contactless delle carte si basa sull'antenna NFC del dispositivo, la cui posizione varia a seconda del modello. * **Raccomandazione:** se possibile, mostri nell'app una breve animazione o un suggerimento *prima* di chiamare l'SDK, indicando all'utente dove si trova il chip NFC sul suo specifico dispositivo (di solito sul retro, in alto o al centro). ## Gestione dei risultati [#handling-results] ### Esito positivo [#success-state] * **Conferma visiva:** mostri una schermata “Operazione riuscita” chiara, con un segno di spunta verde o un analogo segnale positivo. * **Ricevute:** offra subito la possibilità di inviare una ricevuta digitale (email/SMS) o di stamparla, se è collegata una stampante. ### Esito negativo [#failure-state] * **Messaggi di errore chiari:** se una transazione non va a buon fine, traduca i codici di errore tecnici in un linguaggio comprensibile per l'utente. * *Tecnico:* `DECLINED_INSUFFICIENT_FUNDS` * *Per l'utente:* “Transazione rifiutata. Verifichi il saldo o provi con un'altra carta.” * **Possibilità di riprovare:** fornisca un pulsante “Riprova” ben visibile, in modo che l'esercente possa riavviare rapidamente il processo senza reinserire l'importo. ## App Tapaya Terminal [#tapaya-terminal-app] L'app Tapaya Terminal consente agli esercenti di accettare pagamenti con carta in autonomia. Gli integratori possono personalizzare l'esperienza dell'esercente nell'app Tapaya Terminal; per iniziare, contatti [developers@tapaya.com](mailto:developers@tapaya.com). ### Personalizzazione dell'interfaccia [#ui-customization] Può modificare l'interfaccia dell'app Tapaya Terminal nella Tapaya Platform, in **Settings > Application > App Theme**, oppure in modo programmatico tramite la [Platform API](/platform-api). Colori e asset del brand (logo, logotipi) vengono applicati in modo uniforme in tutta l'app Tapaya Terminal. ## Accessibilità [#accessibility] * **Audio:** l'SDK emette segnali acustici per le letture della carta e per gli errori. Si assicuri che l'app non disattivi il volume di sistema né interferisca con il focus audio durante un pagamento. * **Feedback aptico:** l'SDK usa la vibrazione per confermare la lettura della carta. Questo è fondamentale per l'accessibilità e come feedback generale in ambienti rumorosi.