# Flusso notifiche

#### Notifiche

Le notifiche vengono inviate al verificarsi di determinati “eventi”.

Ogni **Evento** è composto da due parti, **Entity** e **State**, nella forma `entity.state`: l’**Entity** è il soggetto principale (ad esempio `tspay_pis`) mentre **State** si riferisce allo status dell’Entity (ad esempio `active`).

Esempi di eventi:

- `tspay_charge.active`
- `tspay_payout.refunded`
- `tspay_registration.active`



Gli eventi previsti, con i relativi stati, sono i seguenti:

<table border="1" id="bkmrk-servizio-entit%C3%A0-stat" style="border-collapse: collapse; width: 100%; height: 790px;"><tbody><tr style="height: 29px;"><td class="align-center" style="height: 29px; width: 14.074%;">**Servizio**</td><td class="align-center" style="height: 29px; width: 14.8149%;">**Entity**</td><td class="align-center" style="height: 29px; width: 19.2593%;">**State**</td><td class="align-center" style="height: 29px; width: 51.7283%;">**Descrizione**</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;">[Incasso (3)](https://digital-docs.ts-paas.com/books/tspay-gateway/page/servizi-integrati#bkmrk-mandatorio-all%27incas "Servizi integrati")</td><td style="width: 14.8149%; height: 29px;">`<a href="https://digital-docs.ts-paas.com/books/tspay-gateway/page/notifiche-da-entita-source">tspay_source</a>`</td><td style="height: 29px; width: 19.2593%;">`active`</td><td style="height: 29px; width: 51.7283%;">Memorizzazione sorgente Link2Save andata a buon fine</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="height: 29px; width: 19.2593%;">`error`</td><td style="height: 29px; width: 51.7283%;">Memorizzazione sorgente Link2Save andata in errore</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;">`<a href="https://digital-docs.ts-paas.com/books/tspay-gateway/page/notifiche-da-entita-charge" title="Notifiche da entità "charge"">tspay_charge</a>`</td><td style="height: 29px; width: 19.2593%;">`pending`</td><td style="height: 29px; width: 51.7283%;">Per l'SDD, nel tempo necessario all'elaborazione del pagamento</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="height: 29px; width: 19.2593%;">`active`</td><td style="height: 29px; width: 51.7283%;"><div>Pagamento andato a buon fine</div></td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="height: 29px; width: 19.2593%;">`error`</td><td style="height: 29px; width: 51.7283%;">Pagamento andato in errore</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="height: 29px; width: 19.2593%;">`refunded`</td><td style="height: 29px; width: 51.7283%;">Pagamento rimborsato</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="height: 29px; width: 19.2593%;">`disputeCreated`</td><td style="height: 29px; width: 51.7283%;">Contestazione creata</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="width: 19.2593%; height: 29px;">`disputeWithdrawn`</td><td style="width: 51.7283%; height: 29px;">Contestazione con importo trattenuto</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="width: 19.2593%; height: 29px;">`disputeUpdated`</td><td style="width: 51.7283%; height: 29px;">Contestazione aggiornata a seguito di invio prove</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="width: 19.2593%; height: 29px;">`disputeClosedLost`</td><td style="width: 51.7283%; height: 29px;">Contestazione persa</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="width: 19.2593%; height: 29px;">`disputeClosedWon`</td><td style="width: 51.7283%; height: 29px;">Contestazione vinta</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="width: 19.2593%; height: 29px;">`disputeClosed`</td><td style="width: 51.7283%; height: 29px;">Contestazione chiusa</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="width: 19.2593%; height: 29px;">`disputeRefunded`</td><td style="width: 51.7283%; height: 29px;">Contestazione rimborsata</td></tr><tr style="height: 32px;"><td style="width: 14.074%; height: 32px;"> </td><td style="width: 14.8149%; height: 32px;">`<a href="https://digital-docs.ts-paas.com/link/167#bkmrk-page-title" title="Notifiche da entità "charge"">tspay_wire</a>`</td><td style="width: 19.2593%; height: 32px;">`pending`</td><td style="width: 51.7283%; height: 32px;">Accredito in corso</td></tr><tr style="height: 30px;"><td style="width: 14.074%; height: 30px;"> </td><td style="width: 14.8149%; height: 30px;"> </td><td style="width: 19.2593%; height: 30px;">`done`</td><td style="width: 51.7283%; height: 30px;">Accredito eseguito</td></tr><tr style="height: 30px;"><td style="width: 14.074%; height: 30px;"> </td><td style="width: 14.8149%; height: 30px;"> </td><td style="width: 19.2593%; height: 30px;">`failed`</td><td style="width: 51.7283%; height: 30px;">Accredito fallito</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="width: 19.2593%; height: 29px;">`reverted`</td><td style="width: 51.7283%; height: 29px;">Accredito stornato</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="width: 19.2593%; height: 29px;">`expired`</td><td style="width: 51.7283%; height: 29px;">Accredito non confermato</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="width: 19.2593%; height: 29px;">`error`</td><td style="width: 51.7283%; height: 29px;">Accredito in errore</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;">[Pagamento (7)](https://digital-docs.ts-paas.com/books/tspay-gateway/page/servizi-integrati#bkmrk-disposizione-di-ordi "Servizi integrati")</td><td style="width: 14.8149%; height: 29px;">`<a href="https://digital-docs.ts-paas.com/books/tspay-gateway/page/notifiche-da-entita-pis">tspay_pis</a>`</td><td style="height: 29px; width: 19.2593%;">`pending`</td><td style="height: 29px; width: 51.7283%;">Pagamento in corso</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="height: 29px; width: 19.2593%;">`active`</td><td style="height: 29px; width: 51.7283%;">Pagamento eseguito</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="height: 29px; width: 19.2593%;">`failed`</td><td style="height: 29px; width: 51.7283%;">Pagamento fallito</td></tr><tr style="height: 30px;"><td style="width: 14.074%; height: 30px;"> </td><td style="width: 14.8149%; height: 30px;"> </td><td style="height: 30px; width: 19.2593%;">`error`</td><td style="height: 30px; width: 51.7283%;">Pagamento andato in errore</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;">[Conti (8)](https://digital-docs.ts-paas.com/books/tspay-gateway/page/servizi-integrati#bkmrk-informazione-e-aggre "Servizi integrati")</td><td style="width: 14.8149%; height: 29px;">`<a href="https://digital-docs.ts-paas.com/books/tspay-gateway/page/notifiche-consenso">tspay_consent</a>`</td><td style="height: 29px; width: 19.2593%;">`created`</td><td style="height: 29px; width: 51.7283%;">Consenso creato</td></tr><tr style="height: 29px;"><td style="width: 14.074%; height: 29px;"> </td><td style="width: 14.8149%; height: 29px;"> </td><td style="height: 29px; width: 19.2593%;">`renewed`</td><td style="height: 29px; width: 51.7283%;">Consenso rinnovato</td></tr><tr style="height: 30px;"><td style="width: 14.074%; height: 30px;"> </td><td style="width: 14.8149%; height: 30px;"> </td><td style="height: 30px; width: 19.2593%;">`in_expiration`</td><td style="height: 30px; width: 51.7283%;">Consenso in scadenza</td></tr></tbody></table>

---

#### Schema

Tutte le notifiche hanno il seguente schema:<svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg>

- `itemId` company registry dell'azienda per la quale si è verificato l'evento notificato
- `entity` entità
- `state` stato
- `event` evento
- `eventTime` timestamp
- `payload` parte variabile dipendente dal tipo di evento. Dettagli in basso.

##### Payload specifici per entità:

Di seguito i riferimenti allo schema dei vari payload:<svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg>

- Notifiche da entità `tspay_source`: [specifiche payload](https://digital-docs.ts-paas.com/books/tspay-gateway/page/notifiche-da-entita-source)
- Notifiche da entità `tspay_charge`: [specifiche payload](https://digital-docs.ts-paas.com/books/tspay-gateway/page/notifiche-da-entita-charge "Notifiche da entità "charge"")
- Notifiche da entità `tspay_wire`: [specifiche payload](https://digital-docs.ts-paas.com/link/167#bkmrk-page-title "Notifiche da entità "charge"")
- Notifiche da entità `tspay_pis`: [specifiche payload](https://digital-docs.ts-paas.com/books/tspay-gateway/page/notifiche-da-entita-pis)
- Notifiche da entità `tspay_consent`: [specifiche payload](https://digital-docs.ts-paas.com/books/tspay-gateway/page/notifiche-consenso)