In questa guida tutti gli endpoint sono descritti senza il prefisso `/api/vX` che va dunque anteposto
# Incasso ### Fattura attiva #### Descrizione Consente di ricevere un pagamento attraverso il servizio di TS Pay; chiamando l'endpoint **link2pay** si riceverà un'url col quale sarà possibile fare un pagamento. --- #### [Richiesta link per effetture un pagamento](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/createLinkToPay) Genera un link per effettuare un pagamento attraverso il servizio di TS Pay. ``` [POST] /{itemId}/link2pay ``` Nella **request** in particolare abbiamo: - `template` contenente il testo ed eventualmente il logo da visualizzare nella pagina del pagamento generata e raggiungibile al link restituito in risposta - `title` titolo, generalmente usato per indicare la ragione sociale del merchant (es: "TeamSystem S.p.A.") - `desc` motivazione del pagamento (es: "Fattura di vendita") - `paymentRef` estremi della fattura (es: "Numero 123 del 15/06/2020") - `logo` link all'immagine da visualizzare come logo - `callbackUrl` url cui reindirizzare l'utente una volta completata l'operazione. facoltativo - `sourceTypes` sorgenti di pagamento accettate: carta di credito, SDD o entrambi (default) - `maxPaymentsNumber` numero massimo di pagamenti consentiti (0=illimitato) - `amount` l'importo da pagare espresso come numero intero in cui le ultime due cifre compongono la parte decimale (ad es. 1450 è da considerare come 14,50) - `externalRef` un riferimento univoco al pagatore, da utilizzare in seguito come elemento di ricerca - `metadata` elementi di tracciabilità, da utilizzare per la riconciliazione Nella **response** l'API fornisce: - `orderKey` identificativo dell'ordine - `url` link da utilizzare per eseguire l'operazione --- #### [Richiesta link per memorizzare una sorgente di pagamento per addebiti futuri](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/createLinkToSave) Genera un link per salvare una sorgente di pagamento attraverso il servizio di TS Pay. ``` [POST] /{itemId}/link2save ``` Nella **request** in particolare abbiamo: - `template` contenente il testo ed eventualmente il logo da visualizzare nella pagina del pagamento generata e raggiungibile al link restituito in risposta - `title` titolo, generalmente usato per indicare la ragione sociale del merchant (es: "TeamSystem S.p.A.") - `desc` motivazione del pagamento (es: "Fattura di vendita") - `paymentRef` estremi della fattura (es: "Numero 123 del 15/06/2020") - `logo` link all'immagine da visualizzare come logo - `callbackUrl` url cui reindirizzare l'utente una volta completata l'operazione. facoltativo - `sourceTypes` sorgenti di pagamento accettate: carta di credito, SDD o entrambi (default) - `maxSourceNumber` numero massimo di sorgenti memorizzabili (0=illimitato, default=1) - `maxAmount` l'importo massimo per gli addebiti, inteso come cumulativo, espresso come numero intero in cui le ultime due cifre compongono la parte decimale (ad es. 1450 è da considerare come 14,50) - `contextId` il contesto a cui la memorizzazione della sorgente si applica, quindi nel caso specifico la fattura - `externalRef` un riferimento univoco al pagatore, da utilizzare in seguito come elemento di ricerca - `metadata` elementi di tracciabilità, da utilizzare per la riconciliazione Nella **response** l'API fornisce: - `orderKey` identificativo dell'ordine - `url` link da utilizzare per eseguire l'operazione --- #### [Addebito](https://ts-pay-gateway-dev.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/createCharge) Esegue l'addebito sulla sorgente salvata con il LinkToSave. ``` [POST] /{itemId}/charges ``` Tra gli **header** è previsto: - `x-operation-key` chiave univoca dell'addebito con lo scopo di prevenire i doppi incassi, in modo che se si tenta una seconda operazione con la stessa chiave viene restituito un errore (opzionale) Nella **request** in particolare abbiamo: - `sourceKey` identifica la sorgente di pagamento memorizzata dal customer attraverso il LinkToSave - `contextId` l'eventuale contesto precedentemente impostato - `description` è la motivazione del pagamento, che finisce nel movimento - `amount` l'importo da addebitare espresso come numero intero in cui le ultime due cifre compongono la parte decimale (ad es. 1450 è da considerare come 14,50) Nella **response** l'API fornisce: - `orderKey` identificativo dell'ordine - `chargeKey` identificativo dell'addebito --- #### [Esito pagamanto](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/getChargesByOrderKey) Da utilizzare per conoscere tutti i dettagli dell'addebito. ``` [GET] /{itemId}/charges/orders/{orderKey} ``` I **parametri** richiesti sono: - `orderKey` path variable - key dell'ordine, ritornato dalla [chiamata alla creazione della richiesta di pagamento](#bkmrk-addebito). # Conti ### Aggregazione conti e carte #### Descrizione Consente di recuperare le informazioni aggregate di saldo e movimenti relativi a conti corrente e carte di credito tramite il servizio di TS Pay. La SCA è unica ma va rinnovata periodicamente, in genere ogni 90 giorni. --- #### [Informazioni conti collegati](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/getLinkedAccounts) Restituisce l'elenco dei prodotti (conti e carte) collegati, comprensivo di saldo disponibile e informazioni relative al consenso. ``` [GET] /{itemId}/linked-accounts ``` Nella **response** l'API fornisce: - `accountId` id del conto/carta - `iban` iban del conto (se il prodotto è un conto corrente) - `maskedPan` numero della carta mascherato (se il prodotto è una carta) - `currency` valuta di conto - `providerId` id del provider (ASPSP) - `bankName` nome della banca - `productCode` codice del prodotto - `lastBalance` saldo - `amount` importo (espresso come numero intero in cui le ultime due cifre compongono la parte decimale) - `currency` valuta - `lastBalanceDate` data di riferimento del saldo - `accountNature` natura del conto - `consentId` id del consenso - `consentExpireDate` data di scadenza del consenso - `lastRefreshStatus` stato ultimo aggiornamento - `lastRefreshDate` data ultimo aggiornamento --- #### [Informazioni conti collegati o precedentemente utilizzati](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/getAccounts) Restituisce l'elenco dei prodotti (solo conti) collegati o precedentemente utilizzati. I primi comprensivi di saldo disponibile e informazioni relative al consenso. ``` [GET] /{itemId}/accounts ``` Nella **response** l'API fornisce: - `accountId` id del conto/carta (solo per conti collegati) - `iban` iban del conto - `currency` valuta di conto - `providerId` id del provider (ASPSP) - `bankName` nome della banca - `productCode` codice del prodotto - `lastBalance` saldo (solo per conti collegati) - `amount` importo (espresso come numero intero in cui le ultime due cifre compongono la parte decimale) - `currency` valuta - `lastBalanceDate` data di riferimento del saldo (solo per conti collegati) --- #### [Informazioni movimenti](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/getTransactions) Restituisce le informazioni relative alle transazioni dei conti collegati. ``` [GET] /{itemId}/transactions ``` I **parametri** richiesti sono: - `dateFrom` data inizio movimenti (opzionale) - `dateTo` data fine movimenti (opzionale) - `bookingStatus` stato del movimento (booked o pending) (opzionale) - `accounts` accounts per i quali mostrare i movimenti (opzionale) Nella **response** l'API fornisce: - `accountId` identifica il conto a cui la transazione fa riferimento - `bookingStatus` stato del movimento (booked o pending) - `bookingDate` data del movimento - `remittanceInformationUnstructured` descrizione del movimento - `transactionAmount` importo movimento - `amount` importo (espresso come numero intero in cui le ultime due cifre compongono la parte decimale) - `currency` valuta - `valueDate` data valuta --- #### [Aggiornamento dati di un conto](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/refreshAccount) Una volta collegato un conto/carta è necessario fare un aggiornamento dei dati, per scaricare transazioni e saldi. Questa operazione è schedulata tutte le notti, ma si può anche eseguire a richiesta tramite la seguente API. Va fatta per tutti gli account collegati con quel determinato consenso. ``` [POST] /{itemId}/accounts/{accountId}/refresh ``` I **parametri** richiesti sono: - `accountId` path variable - identifica il conto Nel corpo della **request** in particolare abbiamo: - `psuIpAddress` IP del client che effettua la richiesta (è richiesto un indirizzo IP valido) Nella **response** l'API fornisce: - `accountId` identifica il conto - `status` stato dell'operazione di refresh (tipicamente "*updating*") # Pagamento ### Fattura passiva #### Descrizione Consente di effettuare un bonifico singolo, per una o più fatture/scadenze relative allo stesso beneficiario. La SCA è richiesta ad ogni operazione, fatte salve specifiche esenzioni previste dalla normativa. --- #### [Inizializzazione pagamento](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/createPayment) Inizializza un pagamento tramite SCT. ``` [POST] /{itemId}/payments ``` Nella **request** in particolare abbiamo: - `externalRef` un riferimento univoco al creditore, da utilizzare in seguito come elemento di ricerca - `metadata` elementi di tracciabilità, da utilizzare per la riconciliazione - `providerId` id del provider (ASPSP, la banca) - `productCode` id del prodotto selezionato - `psuIpAddress` indirizzo IP del richiedente - `debtorAccount` conto del pagatore - `iban` iban - `currency` valuta - `creditorAccount` conto del creditore - `iban` iban - `currency` valuta - `creditorName` nome - `amount` importo (espresso come numero intero in cui le ultime due cifre compongono la parte decimale) - `currency` valuta - `requestedExecutionDate` data di esecuzione - `requestedExecutionTime` ora di esecuzione - `remittanceInformations` descrizione (causale) - `paymentProduct` SCT o SCTinst - `tppRedirectUri` URL di redirect Per conoscere `productCode` e `providerId` va preventivamente invocato [l'endpoint per la lettura dei conti](https://digital-docs.ts-paas.com/link/125#bkmrk-informazioni-account). Nella **response** l'API fornisce: - `paymentId` id del pagamento (al momento ciascun gruppo contiene un solo pagamento) - `status` stato dell'operazione - `totalTransactionFees` commissioni totali della transazione - `scaManagerRedirectUrl` URL di redirect allo SCA manager --- #### [Esito pagamento](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/getPayment) Interroga l'esito del pagamento. ``` [GET] /{itemId}/payments/{paymentId} ``` I **parametri** richiesti sono: - `paymentId` path variable - id del pagamento, ritornato dalla [chiamata all'inizializzazione dello stesso](#bkmrk-informazioni-account) - `psuIpAddress` query string - indirizzo IP del client Nella **response** l'API fornisce: - `paymentId` id del pagamento - `status` stato dell'operazione - `totalTransactionFees` commissioni totali della transazione - `totalAmount` importo totale della transazione - `amount` importo (espresso come numero intero in cui le ultime due cifre compongono la parte decimale) - `currency` valuta - `debtorAccount` iban del debitore - `creditorAccount` iban del creditore - `createdOn` data operazione # Consenso SCA ### Effettuare una SCA #### Descrizione In questa sezione vengono elencati gli endpoint che consentono di ottenere e rinnovare i vari consensi necessari al collegamento di un conto. --- #### [Ottenimento consenso una-tantum per mostrare la lista dei conti](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/createAccountListConsent) Consente di effettuare la SCA (usa e getta) per accedere ai conti/carte in proprio possesso presso la banca, per il prodotto definito nel productId. ``` [POST] /{itemId}/consents/accountsList ``` Nella **request** in particolare abbiamo: - `providerId*` id della banca (o provider) - `productCode*` codice del prodotto - `accountNature*` natura dell'account ("account" o "card") - `tppRedirectUri` URL di redirect dopo che la SCA viene effettuata Nella **response** l'API fornisce: - `consentId` id del consenso - `consentStatus` stato del consenso - `scaManagerRedirectUrl` URI per effettuare la SCA - `validUntil` data fine validità --- #### [Ottenimento consenso ricorrente](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/createRecurringConsents) Consente di effettuare la SCA (valida tipicamente 90 giorni) per collegare ai conti/carte in proprio possesso presso la banca, per il prodotto selezionato. ``` [POST] /{itemId}/consents/recurring ``` Nella **request** in particolare abbiamo: - `providerId*` id della banca (o provider) - `productCode*` codice del prodotto - `tppRedirectUri` URL di redirect dopo che la SCA viene effettuata - `accountAccess*` oggetto composto da - `balances*` lista di oggetti con la seguente forma: - `resourceId*` - `iban` - `maskedPan` - `currency*` - `accountNature` - `transactions*` lista di oggetti con la stessa forma di `balances` - `accounts` lista di oggetti con la stessa forma di `balances` Nella **response** l'API fornisce: - `consentId` id del consenso - `consentStatus` stato del consenso - `scaManagerRedirectUrl` URI per effettuare la SCA - `validUntil` data fine validità --- #### [Rinnovo di un consenso](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/renewConsent) Consente di rinnovare la SCA (valida tipicamente 90 giorni) a partire da un consenso precedentemente valido. ``` [PUT] /{itemId}/consents/{consentId}/renew ``` I **parametri** richiesti sono: - `consentId` path variable - id del consenso. Nella **response** l'API fornisce: - `consentId` id del consenso - `consentStatus` stato del consenso - `scaManagerRedirectUrl` URI per effettuare la SCA - `validUntil` data fine validità --- #### [Revoca di un consenso](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/deleteConsent) Consente di rinnovare la SCA (valida tipicamente 90 giorni) a partire da un consenso precedentemente valido. ``` [DELETE] /{itemId}/consents/{consentId} ``` I **parametri** richiesti sono: - `consentId` path variable - id del consenso. Nella **response** l'API torna il consenso stesso, con lo status aggiornato. --- #### [Recuperare i conti collegati ad un consenso](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/getAccountsByConsentId) Consente di recuperare l'elenco dei conti/carte in proprio possesso presso la banca a fronte del consenso precedentemente fornito. ``` [GET] /{itemId}/consents/{consentId}/accounts ``` I **parametri** richiesti sono: - `consentId` path variable - id del consenso. Nella **response** l'API fornisce: - `accounts` lista degli account composti dalle seguenti proprietà - `accountId` stato del consenso - `resourceId` id della risorsa - `iban` codice IBAN - `currency` valuta di conto - `providerId` id della banca - `productCode` codice del prodotto - `consentId` id del consenso # Banche e Prodotti #### Descrizione In questa sezione vengono elencati gli endpoint che consentono di ottenere informazioni riguardante le banche e i prodotti associati. --- #### [Banche](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/getBanks) Consente di recuperare l'elenco delle banche. ``` [GET] /{itemId}/banks ``` Nella **response** l'API fornisce: - `id` id della banca (o provider) da utilizzare come *bankId* (o *providerId*) nelle varie chiamate - `aspspCode` codice ASPSP - `satus` stato - `businessName` descrizione della banca - `aisInfo` informazioni relative al servizio [**Conti**](https://digital-docs.ts-paas.com/books/tspay-gateway/page/conti) - `globalBankConsent` consenso globale supportato - `supportedNatures` nature supportate (conto, carta o entrambi) - `logo` URL del logo della banca - `readyToUse` indica che la banca è pronta per essere utilizzata dal servizio - `supportedPaymentProducts` modalità di pagamento supportate - `SCT-IT` SCT Italia - `SCT-EU` SCT Europa - `IP` SCT instantaneo - `CB` Cross-border - `T2` Target 2 --- #### [Prodotti](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/getBankProducts) Consente di recuperare l'elenco dei prodotti di una determinata banca. ``` [GET] /{itemId}/banks/{bankId}/products ``` Il parametro `bankId` fa riferimento all'id della banca ottenibile chiamando l'endpoint [Banche](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/getBanks) sopra. Nella **response** l'API fornisce: - `aspspProductCode` codice del prodotto da utilizzare come *productCode* nelle varie chiamate - `aspspProductDescription` descrizione prodotto estesa - `aspspProductUuid` uuid del prodotto - `aspspProductSuggestedLabel`descrizione sintetica del prodotto # Settings #### Descrizione In questa sezione vengono elencati gli endpoint riguardanti le impostazioni/configurazioni di pay-gateway --- #### [Configurazione di pagamento](https://ts-pay-gateway-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/API/getSettingsConfig) ``` [GET] /{itemId}/settings/config ``` **Response**: - `minChargeAmount`: importo minimo transazione (in centesimi) - `maxChargeAmount`: importo massimo transazione (in centesimi) - `balanceRefundReserve`: esposizione massima per rimborso (in centesimi) - `minWireAmount`: importo minimo accredito (in centesimi) - `maxWireAmount`: importo massimo accredito (in centesimi) - `netChargeEnabled`: incasso tramite SDD al netto abilitato - `payoutBlocked`: accredito bloccato # Casi d'uso # Collegamento conto Per collegare un conto o carta è necessario seguire i seguenti passi: 1. Selezione della banca a cui appartiene il conto da collegare - [Banche](https://digital-docs.ts-paas.com/link/139#bkmrk-inizizalizza-un-paga) 2. Selezione del prodotto bancario a cui appartiene il conto - [Prodotti](https://digital-docs.ts-paas.com/link/139#bkmrk-consente-di-recupera-0) 3. Prestazione del consenso una-tantum per accedere ai conti e carte - [Consenso una-tantum](https://digital-docs.ts-paas.com/link/135#bkmrk-inizizalizza-un-paga) 4. Selezione dei conti e carte da collegare tra quelli disponibili legati al consenso precedente - [Recuperare i conti collegati ad un consenso](https://digital-docs.ts-paas.com/link/135#bkmrk-consente-di-recupera-0) 5. Prestazione del consenso ricorrente per collegare i conti e carte - [Ottenimento consenso ricorrente](https://digital-docs.ts-paas.com/link/135#bkmrk-consente-di-effettua) 6. Elenco dei conti e carte collegati con un determinato consenso - [Recuperare i conti collegati ad un consenso](https://digital-docs.ts-paas.com/link/135#bkmrk-consente-di-recupera-0) 7. Aggiornamento dei dati - [Aggiornamento conti](https://digital-docs.ts-paas.com/link/125#bkmrk-una-volta-collegato-) # 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:| **Servizio** | **Entity** | **State** | **Descrizione** |
| [Incasso (3)](https://digital-docs.ts-paas.com/books/tspay-gateway/page/servizi-integrati#bkmrk-mandatorio-all%27incas "Servizi integrati") | `tspay_source` | `active` | Memorizzazione sorgente Link2Save andata a buon fine |
| `error` | Memorizzazione sorgente Link2Save andata in errore | ||
| `tspay_charge` | `pending` | Per l'SDD, nel tempo necessario all'elaborazione del pagamento | |
| `active` | Pagamento andato a buon fine | ||
| `error` | Pagamento andato in errore | ||
| `refunded` | Pagamento rimborsato | ||
| `disputeCreated` | Contestazione creata | ||
| `disputeWithdrawn` | Contestazione con importo trattenuto | ||
| `disputeUpdated` | Contestazione aggiornata a seguito di invio prove | ||
| `disputeClosedLost` | Contestazione persa | ||
| `disputeClosedWon` | Contestazione vinta | ||
| `disputeClosed` | Contestazione chiusa | ||
| `disputeRefunded` | Contestazione rimborsata | ||
| `tspay_wire` | `pending` | Accredito in corso | |
| `done` | Accredito eseguito | ||
| `failed` | Accredito fallito | ||
| `reverted` | Accredito stornato | ||
| `expired` | Accredito non confermato | ||
| `error` | Accredito in errore | ||
| [Pagamento (7)](https://digital-docs.ts-paas.com/books/tspay-gateway/page/servizi-integrati#bkmrk-disposizione-di-ordi "Servizi integrati") | `tspay_pis` | `pending` | Pagamento in corso |
| `active` | Pagamento eseguito | ||
| `failed` | Pagamento fallito | ||
| `error` | Pagamento andato in errore | ||
| [Conti (8)](https://digital-docs.ts-paas.com/books/tspay-gateway/page/servizi-integrati#bkmrk-informazione-e-aggre "Servizi integrati") | `tspay_consent` | `created` | Consenso creato |
| `renewed` | Consenso rinnovato | ||
| `in_expiration` | Consenso in scadenza |
| **Campo** | **Tipo** | **Descrizione** |
| `amount` | integer | importo lordo |
| `currency` | string | valuta |
| `chargeKey` | string | id riferimento pagamento |
| `state` | string | stato pagamento |
| `upstreamRef` | string | flusso stati |
| `orderKey` | string | id riferimento ordine |
| `customerKey` | string | id riferimento cliente |
| `upstreamStatus` | string | stato pagamento |
| `fees` | array | commissioni |
| `netAmount` | integer | importo netto |
| `modifiedOn` | string | data di modifica |
| `createdOn` | string | data di creazione |
| `payMethod` | string | metodo di pagamento (card, SDD) |
| `order` | array | dettaglio richiesta di riferimento |
| **Campo** | **Tipo** | **Descrizione** |
| `orderKey` | string | id richiesta di riferimento |
| `sourceKey` | string | id riferimento sorgente di pagamento |
| `createdOn` | string | data creazione |
| `modifiedOn` | string | data modifica |
| `type` | string | tipo sorgente di pagamento (card, sepa\_debit) |
| `last4` | string | ultime 4 cifre del numero identificativo della sorgente (carta o IBAN) |
| `expiration` | string | data di scadenza in formato mm/yyyy (solo carta) |
| `brand` | string | tipo di network (Visa, MasterCard, American Express, ecc...) (solo carta) |
| `funding` | string | tipologia di carta (credit, debit, prepaid) (solo carta) |
| `order` | array | dettaglio richiesta riferimento |
| **Campo** | **Tipo** | **Descrizione** |
| `paymentId` | string | id del pagamento |
| `amount` | long | importo |
| `currency` | string | valuta |
| `remittanceInfo` | string | descrizione (causale) |
| `debtorIban` | string | iban del debitore |
| `creditorIban` | string | iban del creditore |
| `creditorName` | string | nome del creditore |
| `externalRef` | string | un riferimento univoco al creditore, da utilizzare in seguito come elemento di ricerca |
| `metadata` | string | elementi di tracciabilità, da utilizzare per la riconciliazione |
| `providerId` | string | id del provider (ASPSP) |
| `productCode` | string | id del prodotto |
| `paymentProduct` | string | SCT o SCTinst |
| **Campo** | **Tipo** | **Descrizione** |
| `type` | non utilizzato | |
| `consentId` | string | id del consenso |
| `providerId` | string | id della banca (o provider) |
| `productCode` | string | codice prodotto |
| `validUntil` | string | data scadenza consenso |
| `externalRef` | string | riferimento esterno |
| `metadata` | string | dati di tracciabilità |
| `accounts` | array | elenco conti/carte riferiti al consenso |
| **Campo** | **Tipo** | **Descrizione** |
| `iban` | string | codice iban (per i conti) |
| `maskedPan` | string | numero della carta (criptato) |
| `currency` | string | valuta |
| **Campo** | **Tipo** | **Descrizione** |
| `amount` | integer | importo lordo |
| `beneName` | string | nome beneficiario |
| `createdOn` | string | data di creazione |
| `currency` | string | valuta |
| `fees` | array | commissioni |
| `iban` | string | iban beneficiario |
| `modifiedOn` | string | data di modifica |
| `netAmount` | integer | importo netto |
| `payScheduleRef` | string | riferimento accredito |
| `state` | string | stato |
| `wireDesc` | string | descrizione accredito |
| `wireKey` | string | id accredito |