# Notifiche

# Overview

Il sistema di notiche degli eventi che arrivano da TsPay sfrutta NCS per il loro smistamento all'interno di Digital.

Le applicazioni che si integrano via pay-gateway, e che hanno effettuato la configurazione per ricevere le notifiche via NCS, riceveranno tutte le notifiche, comprese quelle relative ad eventi scatenati da altre applicazioni, che sono anch'esse integrate via pay-gateway. Questo per due motivi:

1. Tutte le applicazioni che si integrano via pay-gateway si "presentano" a TsPay come singola applicazione.
2. Tutte le applicazioni del mondo digital potenzialmente operano sulle stesse aziende e quindi vogliono rimanere allineate sullo stato delle stesse.

È compito quindi della singola applicazione filtrare le notifiche desiderate dalle indesiderate, generalmente tenendo traccia dell'id dell'evento.

# 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)

# Payload notifiche tspay_charge

<table border="1" id="bkmrk-campo-tipo-descrizio-0" style="height: 436px; width: 510px;"><tbody><tr style="height: 29px;"><td class="align-center" style="width: 135.111px; height: 29px;">**Campo**</td><td class="align-center" style="width: 78.2222px; height: 29px;">**Tipo**</td><td class="align-center" style="width: 295.619px; height: 29px;">**Descrizione**</td></tr><tr style="height: 30px;"><td style="width: 135.111px; height: 30px;">`amount`</td><td style="width: 78.2222px; height: 30px;">integer</td><td style="width: 295.619px; height: 30px;">importo lordo</td></tr><tr style="height: 29px;"><td style="width: 135.111px; height: 29px;">`currency`</td><td style="width: 78.2222px; height: 29px;">string</td><td style="width: 295.619px; height: 29px;">valuta</td></tr><tr style="height: 29px;"><td style="width: 135.111px; height: 29px;">`chargeKey`</td><td style="width: 78.2222px; height: 29px;">string</td><td style="width: 295.619px; height: 29px;">id riferimento pagamento</td></tr><tr style="height: 29px;"><td style="width: 135.111px; height: 29px;">`state`</td><td style="width: 78.2222px; height: 29px;">string</td><td style="width: 295.619px; height: 29px;">stato pagamento</td></tr><tr style="height: 29px;"><td style="width: 135.111px; height: 29px;">`upstreamRef`</td><td style="width: 78.2222px; height: 29px;">string</td><td style="width: 295.619px; height: 29px;">flusso stati</td></tr><tr style="height: 29px;"><td style="width: 135.111px; height: 29px;">`orderKey`</td><td style="width: 78.2222px; height: 29px;">string</td><td style="width: 295.619px; height: 29px;">id riferimento ordine</td></tr><tr style="height: 29px;"><td style="width: 135.111px; height: 29px;">`customerKey`</td><td style="width: 78.2222px; height: 29px;">string</td><td style="width: 295.619px; height: 29px;">id riferimento cliente</td></tr><tr style="height: 29px;"><td style="width: 135.111px; height: 29px;">`upstreamStatus`</td><td style="width: 78.2222px; height: 29px;">string</td><td style="width: 295.619px; height: 29px;">stato pagamento</td></tr><tr style="height: 29px;"><td style="width: 135.111px; height: 29px;">`fees`</td><td style="width: 78.2222px; height: 29px;">array</td><td style="width: 295.619px; height: 29px;">commissioni</td></tr><tr style="height: 29px;"><td style="width: 135.111px; height: 29px;">`netAmount`</td><td style="width: 78.2222px; height: 29px;">integer</td><td style="width: 295.619px; height: 29px;">importo netto</td></tr><tr style="height: 29px;"><td style="width: 135.111px; height: 29px;">`modifiedOn`</td><td style="width: 78.2222px; height: 29px;">string</td><td style="width: 295.619px; height: 29px;">data di modifica</td></tr><tr style="height: 29px;"><td style="width: 135.111px; height: 29px;">`createdOn`</td><td style="width: 78.2222px; height: 29px;">string</td><td style="width: 295.619px; height: 29px;">data di creazione</td></tr><tr style="height: 29px;"><td style="width: 135.111px; height: 29px;">`payMethod`</td><td style="width: 78.2222px; height: 29px;">string</td><td style="width: 295.619px; height: 29px;">metodo di pagamento (card, SDD)</td></tr><tr style="height: 29px;"><td style="width: 135.111px; height: 29px;">`order`</td><td style="width: 78.2222px; height: 29px;">array</td><td style="width: 295.619px; height: 29px;">dettaglio richiesta di riferimento</td></tr></tbody></table>

# Payload notifiche tspay_source

<table border="1" id="bkmrk-campo-tipo-descrizio" style="height: 329px; width: 704px;"><tbody><tr style="height: 29px;"><td class="align-center" style="height: 29px; width: 114.794px;">**Campo**</td><td class="align-center" style="height: 29px; width: 90.4127px;">**Tipo**</td><td class="align-center" style="height: 29px; width: 497.778px;">**Descrizione**</td></tr><tr style="height: 30px;"><td style="height: 30px; width: 114.794px;">`orderKey`</td><td style="height: 30px; width: 90.4127px;">string</td><td style="height: 30px; width: 497.778px;">id richiesta di riferimento</td></tr><tr style="height: 30px;"><td style="height: 30px; width: 114.794px;">`sourceKey`</td><td style="height: 30px; width: 90.4127px;">string</td><td style="height: 30px; width: 497.778px;">id riferimento sorgente di pagamento</td></tr><tr style="height: 30px;"><td style="height: 30px; width: 114.794px;">`createdOn`</td><td style="height: 30px; width: 90.4127px;">string</td><td style="height: 30px; width: 497.778px;">data creazione</td></tr><tr style="height: 30px;"><td style="height: 30px; width: 114.794px;">`modifiedOn`</td><td style="height: 30px; width: 90.4127px;">string</td><td style="height: 30px; width: 497.778px;">data modifica</td></tr><tr style="height: 30px;"><td style="height: 30px; width: 114.794px;">`type`</td><td style="height: 30px; width: 90.4127px;">string</td><td style="height: 30px; width: 497.778px;">tipo sorgente di pagamento (card, sepa\_debit)</td></tr><tr style="height: 30px;"><td style="height: 30px; width: 114.794px;">`last4`</td><td style="height: 30px; width: 90.4127px;">string</td><td style="height: 30px; width: 497.778px;">ultime 4 cifre del numero identificativo della sorgente (carta o IBAN)</td></tr><tr style="height: 30px;"><td style="height: 30px; width: 114.794px;">`expiration`</td><td style="height: 30px; width: 90.4127px;">string</td><td style="height: 30px; width: 497.778px;">data di scadenza in formato mm/yyyy (solo carta)</td></tr><tr style="height: 30px;"><td style="height: 30px; width: 114.794px;">`brand`</td><td style="height: 30px; width: 90.4127px;">string</td><td style="height: 30px; width: 497.778px;">tipo di network (Visa, MasterCard, American Express, ecc...) (solo carta)</td></tr><tr style="height: 30px;"><td style="height: 30px; width: 114.794px;">`funding`</td><td style="height: 30px; width: 90.4127px;">string</td><td style="height: 30px; width: 497.778px;">tipologia di carta (credit, debit, prepaid) (solo carta)</td></tr><tr style="height: 30px;"><td style="height: 30px; width: 114.794px;">`order`</td><td style="height: 30px; width: 90.4127px;">array</td><td style="height: 30px; width: 497.778px;">dettaglio richiesta riferimento</td></tr></tbody></table>

# Payload notifiche tspay_pis

<table border="1" id="bkmrk-campo-tipo-descrizio"><tbody><tr><td class="align-center">**Campo**</td><td class="align-center">**Tipo**</td><td class="align-center">**Descrizione**</td></tr><tr><td>`paymentId`</td><td>string</td><td>id del pagamento</td></tr><tr><td>`amount`</td><td>long</td><td>importo</td></tr><tr><td>`currency`</td><td>string</td><td>valuta</td></tr><tr><td>`remittanceInfo`</td><td>string</td><td>descrizione (causale)</td></tr><tr><td>`debtorIban`</td><td>string</td><td>iban del debitore</td></tr><tr><td>`creditorIban`</td><td>string</td><td>iban del creditore</td></tr><tr><td>`creditorName`</td><td>string</td><td>nome del creditore</td></tr><tr><td>`externalRef`</td><td>string</td><td>un riferimento univoco al creditore, da utilizzare in seguito come elemento di ricerca</td></tr><tr><td>`metadata`</td><td>string</td><td>elementi di tracciabilità, da utilizzare per la riconciliazione</td></tr><tr><td>`providerId`</td><td>string</td><td>id del provider (ASPSP)</td></tr><tr><td>`productCode`</td><td>string</td><td>id del prodotto</td></tr><tr><td>`paymentProduct`</td><td>string</td><td>SCT o SCTinst</td></tr></tbody></table>

# Payload notifiche tspay_consent

<table border="1" id="bkmrk-campo-tipo-descrizio-0" style="height: 291px; width: 450px;"><tbody><tr style="height: 29px;"><td class="align-center" style="width: 136px; height: 29px;">**Campo**</td><td class="align-center" style="width: 61px; height: 29px;">**Tipo**</td><td class="align-center" style="width: 253px; height: 29px;">**Descrizione**</td></tr><tr style="height: 30px;"><td style="width: 136px; height: 30px;">`type`</td><td style="width: 61px; height: 30px;"> </td><td style="width: 253px; height: 30px;">non utilizzato</td></tr><tr style="height: 29px;"><td style="width: 136px; height: 29px;">`consentId`</td><td style="width: 61px; height: 29px;">string</td><td style="width: 253px; height: 29px;">id del consenso</td></tr><tr style="height: 29px;"><td style="width: 136px; height: 29px;">`providerId`</td><td style="width: 61px; height: 29px;">string</td><td style="width: 253px; height: 29px;">id della banca (o provider)</td></tr><tr style="height: 29px;"><td style="width: 136px; height: 29px;">`productCode`</td><td style="width: 61px; height: 29px;">string</td><td style="width: 253px; height: 29px;">codice prodotto</td></tr><tr style="height: 29px;"><td style="width: 136px; height: 29px;">`validUntil`</td><td style="width: 61px; height: 29px;">string</td><td style="width: 253px; height: 29px;">data scadenza consenso</td></tr><tr style="height: 29px;"><td style="width: 136px; height: 29px;">`externalRef`</td><td style="width: 61px; height: 29px;">string</td><td style="width: 253px; height: 29px;">riferimento esterno</td></tr><tr style="height: 29px;"><td style="width: 136px; height: 29px;">`metadata`</td><td style="width: 61px; height: 29px;">string</td><td style="width: 253px; height: 29px;">dati di tracciabilità</td></tr><tr style="height: 29px;"><td style="width: 136px; height: 29px;">`accounts`</td><td style="width: 61px; height: 29px;">array</td><td style="width: 253px; height: 29px;">elenco conti/carte riferiti al consenso</td></tr></tbody></table>

ogni oggetto dell'array `accounts` ha i seguenti campi:

<table border="1" id="bkmrk-campo-tipo-descrizio" style="height: 291px;"><tbody><tr style="height: 29px;"><td class="align-center" style="width: 136px; height: 29px;">**Campo**</td><td class="align-center" style="width: 61px; height: 29px;">**Tipo**</td><td class="align-center" style="width: 229px; height: 29px;">**Descrizione**</td></tr><tr style="height: 30px;"><td style="width: 136px; height: 30px;">`iban`</td><td style="width: 61px; height: 30px;">string</td><td style="width: 229px; height: 30px;">codice iban (per i conti)</td></tr><tr style="height: 29px;"><td style="width: 136px; height: 29px;">`maskedPan`</td><td style="width: 61px; height: 29px;">string</td><td style="width: 229px; height: 29px;">numero della carta (criptato)</td></tr><tr style="height: 29px;"><td style="width: 136px; height: 29px;">`currency`</td><td style="width: 61px; height: 29px;">string</td><td style="width: 229px; height: 29px;">valuta</td></tr></tbody></table>

# Payload notifiche tspay_wire

<table border="1" id="bkmrk-campo-tipo-descrizio-1" style="height: 377px; width: 532px;"><tbody><tr style="height: 29px;"><td class="align-center" style="height: 29px; width: 164.571px;">**Campo**</td><td class="align-center" style="height: 29px; width: 97.5238px;">**Tipo**</td><td class="align-center" style="height: 29px; width: 268.19px;">**Descrizione**</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 164.571px;">`amount`</td><td style="height: 29px; width: 97.5238px;">integer</td><td style="height: 29px; width: 268.19px;">importo lordo</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 164.571px;">`beneName`</td><td style="height: 29px; width: 97.5238px;">string</td><td style="height: 29px; width: 268.19px;">nome beneficiario</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 164.571px;">`createdOn`</td><td style="height: 29px; width: 97.5238px;">string</td><td style="height: 29px; width: 268.19px;">data di creazione</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 164.571px;">`currency`</td><td style="height: 29px; width: 97.5238px;">string</td><td style="height: 29px; width: 268.19px;">valuta</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 164.571px;">`fees`</td><td style="height: 29px; width: 97.5238px;">array</td><td style="height: 29px; width: 268.19px;">commissioni</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 164.571px;">`iban`</td><td style="height: 29px; width: 97.5238px;">string</td><td style="height: 29px; width: 268.19px;">iban beneficiario</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 164.571px;">`modifiedOn`</td><td style="height: 29px; width: 97.5238px;">string</td><td style="height: 29px; width: 268.19px;">data di modifica</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 164.571px;">`netAmount`</td><td style="height: 29px; width: 97.5238px;">integer</td><td style="height: 29px; width: 268.19px;">importo netto</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 164.571px;">`payScheduleRef`</td><td style="height: 29px; width: 97.5238px;">string</td><td style="height: 29px; width: 268.19px;">riferimento accredito</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 164.571px;">`state`</td><td style="height: 29px; width: 97.5238px;">string</td><td style="height: 29px; width: 268.19px;">stato</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 164.571px;">`wireDesc`</td><td style="height: 29px; width: 97.5238px;">string</td><td style="height: 29px; width: 268.19px;">descrizione accredito</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 164.571px;">`wireKey`</td><td style="height: 29px; width: 97.5238px;">string</td><td style="height: 29px; width: 268.19px;">id accredito</td></tr></tbody></table>

# Configurazione corrente NCS

Attualmente NCS è configurato per inviare le notifiche:

1. via **webhook** agli applicativi
2. vie **email** agli utenti

1\. Attualmente agli applicativi integrati, che si sono configurati su NCS, vengono inviate tutte le notifiche in arrivo da TsPay. Essendo via webhook, **l'applicativo deve esporre un endpoint su cui essere notificato**. Il payload della chiamata sarà (come già specificato [qui, in schema](https://digital-docs.ts-paas.com/books/tspay-gateway/page/flusso-notifiche)):

```JSON
{
  "itemId": "{{itemId}}",
  "entity": "{{entity}}",
  "state": "{{state}}",
  "event": "{{event}}",
  "eventTime": "{{eventTime}}",
  "payload": "{{payload}}"
}
```

2\. Oltre alle notifiche via webhook per gli applicativi, sono configurate anche le notifiche via email per i soli seguenti eventi: `tspay_consent.renewed`, `tspay_consent.in_expiration`, `tspay_consent.created`.