> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Verifica dello stato di pagamento Pay at Table da POS o dashboard

> Verifica lo stato dei pagamenti Pay at Table di storekit dal POS o dalla dashboard. Gestisci pagamenti parziali, conti divisi e conferma il saldo completo prima della chiusura.

Quando gli ospiti pagano tramite Pay at Table, hai più modi per confermare lo stato del pagamento. Questa guida spiega come verificare se un pagamento è completo, parziale o in sospeso.

## Dal tuo POS

Il modo principale per controllare lo stato del pagamento è tramite il tuo sistema point-of-sale:

* **Sincronizzazione in tempo reale** — quando un ospite paga tramite QR code, il pagamento appare immediatamente sul POS
* **Il conto si chiude automaticamente** — una volta pagato per intero, il conto del tavolo si chiude
* **Pagamenti parziali mostrati** — se gli ospiti dividono il conto, vedrai ogni pagamento man mano che arriva

Controlla la schermata del POS per vedere:

* Saldo residuo sul tavolo
* Singoli pagamenti effettuati
* Se il conto è saldato per intero

## Dalla dashboard storekit

Per una vista completa di tutte le transazioni Pay at Table:

1. Vai su **Ordini** nella dashboard
2. Filtra per ordini **Pay at Table**
3. Visualizza lo stato di pagamento per ogni tavolo

La dashboard mostra:

| Stato          | Significato                           |
| -------------- | ------------------------------------- |
| **Pagato**     | Conto saldato per intero              |
| **Parziale**   | Alcuni articoli pagati, saldo residuo |
| **In sospeso** | Pagamento avviato ma non completato   |
| **Fallito**    | Tentativo di pagamento non riuscito   |

### Dove trovare i pagamenti Pay at Table

I pagamenti QR / Pay at Table non compaiono sempre nello stesso posto degli ordini online normali, quindi è utile sapere dove guardare:

* **Ordini** — vai su **Ordini** e filtra su **Pay at Table** per vedere il conto e lo stato di pagamento di ogni tavolo.
* **Tavoli** — apri **Tavoli**, seleziona il tavolo (o il conto) e fai clic su **Visualizza pagamenti** per vedere i singoli pagamenti effettuati contro quel conto, comprese suddivisioni e mance.

<Info>
  Il report **Analytics → Contabilità → Tutte le transazioni** compare solo quando **storekit Payments** è attivo sul tuo account. Se non vedi una sezione **Contabilità** nella dashboard, il tuo store non usa storekit Payments e dovresti individuare i pagamenti Pay at Table sotto **Ordini** o **Tavoli**. Consulta [Configurazione di storekit Payments](/docs/it/guides/payments/storekit-payments-setup) per attivarlo.
</Info>

## Notifiche di pagamento

Imposta le notifiche per avvisare il personale quando vengono effettuati pagamenti:

1. Vai su **Impostazioni** → **Notifiche**
2. Attiva **Avvisi Pay at Table**
3. Scegli il metodo di notifica (dashboard, email o entrambi)

Riceverai avvisi per:

* Pagamento completo effettuato
* Pagamento parziale ricevuto
* Pagamento fallito

## Comprendere gli stati di pagamento

### Pagato per intero

L'intero conto è stato saldato. Il tavolo è pronto per essere sparecchiato e resettato.

### Parzialmente pagato

Alcuni ospiti hanno pagato la loro parte, ma resta un saldo. Questo accade comunemente quando:

* Gli ospiti stanno dividendo il conto
* Qualcuno sta pagando solo per articoli specifici
* Un gruppo sta pagando a turni

Controlla il saldo residuo sul POS prima di lasciare andare gli ospiti.

### Pagamento in sospeso

Un pagamento è stato avviato ma non ancora confermato. Può verificarsi quando:

* La banca dell'ospite richiede una verifica aggiuntiva
* I ritardi di rete stanno rallentando l'elaborazione
* Il pagamento è in fase di elaborazione

Aspetta qualche istante — la maggior parte dei pagamenti in sospeso si risolve in pochi secondi.

### Pagamento fallito

Il tentativo di pagamento non è andato a buon fine. Motivi comuni:

* Fondi insufficienti
* Carta rifiutata
* Errore di rete

L'ospite vedrà un errore sul telefono e potrà riprovare con un metodo di pagamento diverso.

## Comprendere le voci dell'estratto conto bancario

Occasionalmente un ospite segnala che il suo estratto conto mostra **due voci** per un singolo pagamento Pay at Table, anche se storekit ne mostra solo **una** riuscita. È un normale comportamento di elaborazione delle carte, non un doppio addebito.

I pagamenti con carta vengono generalmente elaborati in due fasi:

| Voce                            | Cos'è                                                                                                                  | Cosa succede                                                                         |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| **In sospeso / autorizzazione** | Un blocco temporaneo posto sulla carta dell'ospite al momento del pagamento, per confermare la disponibilità dei fondi | Compare come *in sospeso* sull'estratto; nessun denaro è stato realmente movimentato |
| **Capture / regolamento**       | L'addebito effettivo che raccoglie i fondi                                                                             | Compare come transazione completata; è il pagamento registrato da storekit           |

La banca dell'ospite può mostrare per un breve periodo sia l'autorizzazione iniziale sia la capture finale una accanto all'altra. L'autorizzazione in sospeso **non** è un addebito extra e **scompare automaticamente dopo qualche giorno** una volta scaduta o riconciliata con la capture. Viene sempre incassato un solo pagamento, ecco perché storekit mostra una singola transazione riuscita.

<Info>
  Se storekit mostra **un** pagamento riuscito per il conto (controlla **Ordini** o **Tavoli → Visualizza pagamenti**), l'ospite è stato addebitato una sola volta. Una seconda riga in sospeso sul suo estratto conto è l'autorizzazione e scomparirà da sola — di solito entro pochi giorni, a seconda della banca dell'ospite.
</Info>

<Tip>
  Se l'ospite è preoccupato, rassicuralo che la voce in sospeso è un blocco temporaneo, non un addebito, e chiedigli di controllare di nuovo dopo qualche giorno. Per qualsiasi cosa che continui a sembrare un vero addebito duplicato dopo che la voce in sospeso scompare, consulta [Rimborsi e payout](/docs/it/guides/payments/refunds-payouts) o [contatta il supporto](/docs/it/getting-started/contact-support).
</Tip>

## Rifiutato sull'estratto ma pagato in storekit

Questo è un caso **diverso** dall'autorizzazione in sospeso descritta sopra. Qui il record bancario dell'ospite mostra il pagamento come **rifiutato**, ma il conto è pagato e l'ordine è stato accettato ed evaso. Tipicamente l'ospite vede due righe per la stessa visita: un tentativo rifiutato e un addebito riuscito per lo stesso importo.

### Perché succede

Un pagamento con carta può essere rifiutato dall'emittente della carta dell'ospite al primo tentativo (fondi insufficienti in quel momento, un controllo antifrode o di velocità, un problema 3-D Secure o CVC) e poi andare a buon fine in un tentativo successivo con la stessa carta. Il tentativo rifiutato compare comunque sull'estratto conto o nelle notifiche della banking app dell'ospite anche se non ha incassato alcun denaro — solo il tentativo riuscito lo fa.

Il secondo tentativo riuscito arriva da uno di questi due luoghi:

* **Il provider di pagamento ha riprovato.** I pagamenti con carta di storekit sono elaborati da Adyen e un retry eseguito dal lato del provider non è visibile a storekit come pagamento separato — storekit registra solo il risultato che gli viene dato.
* **L'ospite ha pagato di nuovo.** Ha riprovato sul telefono, con la stessa carta o una diversa, e quel tentativo è andato a buon fine.

<Warning>
  storekit non ripete l'invio di una carta rifiutata da sé e **non esiste un'impostazione di retry nella dashboard**. Ogni tentativo di pagamento viene inviato una sola volta, con una chiave di idempotenza che impedisce lo stesso tentativo di essere addebitato due volte, e un rifiuto dall'emittente della carta viene registrato come pagamento fallito — mai come pagato. Quindi un conto pagato in storekit è sempre supportato da un pagamento effettivamente approvato dal circuito della carta.
</Warning>

### Quale record è quello autorevole

storekit è il record di ciò che è stato effettivamente incassato per il conto. Una riga rifiutata su un estratto conto è il record di un *tentativo*, non di un movimento di denaro. Se storekit mostra il conto pagato, consideralo pagato — e verificalo passo per passo:

<Steps>
  <Step title="Apri i pagamenti del conto">
    Vai su **Tavoli**, seleziona il tavolo (o il conto) e fai clic su **Visualizza pagamenti**. Ogni pagamento è elencato con **Ora**, **Pagamento**, **Pagato**, **Stato POS** e **Totale**.
  </Step>

  <Step title="Leggi la colonna Pagato">
    La colonna **Pagato** mostra **Pagato**, **In sospeso** o **Fallito** per ogni tentativo. Un badge **Pagato** è un pagamento che l'emittente della carta ha approvato. Passa il cursore su un badge **Fallito** per vedere il motivo fornito dall'emittente per quel tentativo.
  </Step>

  <Step title="Controlla il log delle transazioni">
    Se il tuo account usa storekit Payments (vedi la nota sopra — senza di esso non c'è una sezione **Contabilità**), fai clic su **Analytics**, seleziona **Contabilità**, poi fai clic su **Tutte le transazioni**. Imposta l'intervallo di date al giorno della visita. Il filtro **Stato** ha esattamente due opzioni, **Successo** e **Fallito**, e il motivo del fallimento è mostrato accanto a uno stato fallito. La colonna **Dettagli** mostra le ultime quattro cifre della carta e **Riferimento** rimanda al conto, così puoi abbinare la carta e l'importo dell'ospite ai tentativi registrati.
  </Step>
</Steps>

<Info>
  Vedere un tentativo **Fallito** e un tentativo **Successo** dello stesso importo, a distanza di minuti, è la fotografia attesa per questo caso: il primo tentativo è stato rifiutato, il secondo è stato approvato e solo quello approvato è stato incassato. Se il retry è avvenuto dal lato del provider, storekit mostrerà solo il pagamento riuscito — il tentativo rifiutato esiste sull'estratto dell'ospite ma non è mai stato un pagamento storekit.
</Info>

### Cosa dire all'ospite

* La voce rifiutata è un **tentativo fallito**, non un addebito — nessun denaro è uscito dal suo conto per essa.
* Alcune banche mostrano i tentativi rifiutati sull'estratto o inviano una notifica push per essi; di solito scompaiono dall'estratto e qualsiasi blocco temporaneo si rilascia da solo.
* È stato addebitato **una sola volta** per il conto. Fornisci l'importo e l'orario del pagamento riuscito da **Visualizza pagamenti** in modo che possa abbinarlo sull'estratto.

<Tip>
  Vale la pena contattare il supporto quando i record realmente non tornano — ad esempio una voce rifiutata **senza** alcun pagamento riuscito corrispondente in storekit mentre il saldo dell'ospite è comunque diminuito, due transazioni **Successo** per lo stesso conto in **Tutte le transazioni** o un ospite il cui totale sull'estratto per la visita è superiore al conto. Tieni pronti i valori **ID** e **Riferimento** da **Tutte le transazioni** e [contatta il supporto](/docs/it/getting-started/contact-support). Se il conto è pagato in storekit e l'ospite è stato addebitato una sola volta, non c'è nulla da riconciliare.
</Tip>

## Cosa fare se il pagamento non appare

Se un ospite dichiara di aver pagato ma non lo vedi:

1. **Controlla il POS** — potrebbe esserci un breve ritardo nella sincronizzazione
2. **Chiedi di vedere la conferma** — gli ospiti ricevono una schermata di conferma dopo il pagamento
3. **Controlla la dashboard** — visualizza la transazione nella dashboard di storekit
4. **Verifica il tavolo** — assicurati che abbiano scansionato il QR code del tavolo corretto

<Warning>
  Non lasciare mai andare un ospite senza confermare il pagamento. Nel dubbio, controlla la dashboard o chiedi di vedere la sua schermata di conferma del pagamento.
</Warning>

## Fallimenti di sincronizzazione dei pagamenti dei conti

Quando un ospite paga con successo tramite Pay at Table ma il pagamento non riesce a sincronizzarsi con il POS, riceverai una notifica email. Questo garantisce che non manchi mai un pagamento che necessita di riconciliazione manuale.

### Cosa contiene l'email

La notifica di fallimento del pagamento del conto include:

* **Dettagli del conto** — ID del conto e nome del locale
* **Informazioni sul pagamento** — ID del pagamento e dettagli della transazione
* **Motivo dell'errore** — dettagli tecnici specifici sul motivo del fallimento della sincronizzazione
* **ID di riferimento** — sia gli ID del conto storekit sia quelli del POS per la riconciliazione
* **Azioni rapide** — link diretto per visualizzare il conto nella dashboard

<Warning>
  Il cliente ha già pagato con successo. Il fallimento riguarda solo la sincronizzazione del pagamento con il POS. Potresti dover riconciliare manualmente questo pagamento nel sistema POS.
</Warning>

### Cosa fare quando ricevi questa email

1. **Controlla i dettagli dell'errore** — l'email include informazioni specifiche sul motivo del fallimento della sincronizzazione
2. **Visualizza il conto nella dashboard** — fai clic sul link nell'email per vedere tutti i dettagli del pagamento
3. **Riconcilia manualmente nel POS** — se necessario, contrassegna manualmente il conto come pagato nel POS
4. **Contatta il supporto** — il nostro team di supporto viene notificato automaticamente e può aiutare a risolvere i problemi ricorrenti

### Motivi comuni di fallimento della sincronizzazione

| Motivo                       | Cosa significa                        | Azione                                                |
| ---------------------------- | ------------------------------------- | ----------------------------------------------------- |
| **Timeout di connessione**   | Impossibile raggiungere l'API del POS | Verifica che il sistema POS sia online e connesso     |
| **Errore di autenticazione** | Credenziali POS non valide            | Verifica le impostazioni dell'integrazione            |
| **Conto non trovato**        | Il conto non esiste nel POS           | Controlla che il conto sia stato creato correttamente |
| **Pagamento già registrato** | Il POS ha già questo pagamento        | Nessuna azione necessaria, verifica nel POS           |

<Info>
  Il supporto viene automaticamente notificato di tutti i fallimenti di sincronizzazione dei pagamenti dei conti e può aiutare a risolvere problemi persistenti.
</Info>

## Gestione delle dispute

Se sorge una disputa di pagamento:

1. Controlla la transazione nella dashboard di storekit
2. Prendi nota dell'ID della transazione e del timestamp
3. [Contatta il supporto](/docs/it/getting-started/contact-support) con i dettagli

Tutte le transazioni Pay at Table hanno un audit trail completo di riferimento.

## Suggerimenti per lo staff

* **Controlla il POS regolarmente** — soprattutto durante i periodi di punta
* **Conferma prima di sparecchiare** — verifica sempre il pagamento prima di resettare un tavolo
* **Conosci il ritardo** — i pagamenti compaiono tipicamente entro 2-3 secondi
* **Forma sui pagamenti parziali** — assicurati che lo staff comprenda gli scenari di conto diviso


## Related topics

- [Dine-in (Pay at Table)](/docs/it/getting-started/store-types/dine-in-pay-at-table.md)
- [Store connesso al POS](/docs/it/getting-started/store-types/pos-connected-store.md)
- [Dine-in (Order & Pay)](/docs/it/getting-started/store-types/dine-in-order-and-pay.md)
- [Panoramica su Pay at Table](/docs/it/guides/pay-at-table/overview.md)
- [Metodi di pagamento supportati da storekit](/docs/it/guides/payments/payment-methods.md)
