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
Inizizalizza un pagamento tramite SCT.
[POST] /{itemUuid}/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)
productId: 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 productId e providerId va preventivamente invocato l'endpoint per la lettura dei conti.
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
Interroga l'esito del pagamento
[GET] /{itemUuid}/payments/{paymentId}
I parametri richiesti sono:
paymentId: id del pagamento
psuIpAddress: indirizzo IP del client
Nella response l'API fornisce in particolare:
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