API SCT
L’integrazione delle funzionalità all’interno del tuo gestionale ti permette di disporre un bonifico in euro (SCT) dal tuo conto Intesa Sanpaolo verso banche aderenti al servizio in aerea SEPA. Sono comprese nel contratto tutte le API necessarie per l’esecuzione di un bonifico:
- Dapprima dovrai verificare se la Banca del beneficiario sia aderente allo schema SCT attraverso l’API Reachability
- Una volta verificata la raggiungibilità, dovrai verificare le informazioni contenute nella richiesta ai fini dell’esecuzione del pagamento (inclusa la verifica sintattica IBAN) con l’API Simulation*
- Potrai ora disporre l’ordine di bonifico tramite l’API Execution*
- Dopo l’esecuzione potrai verificare lo stato (es. “eseguito”) delle disposizioni eseguiti nei 18 mesi antecedenti tramite l’API Payment Status
- Potrai richiamare la lista pagamenti disposti negli ultimi 18 mesi con l’API Payment List
- Inoltre, potrai revocare la disposizione di pagamento entro i tempi di cut-off previsti dalla banca con l’API Revoke
I rapporti collegabili a questa API sono conti correnti in Euro e in divisa estera aperti presso filiali di Intesa Sanpaolo SPA.
*L' API Simulation e l' API Execution sono disponibili in due versioni, una con tracciato conforme allo standard ISO20022 ed una versione JSON che richiede l'inserimento di un set di dati semplificato. Si ricorda che il character set ammesso è Latin.
Request
SimulationID
String
Unique identifier of execution, max length 49
USE CASE 16582444847955578a486-13ce-498e-a691-2b9cdd3c099f
debtorName
String
The name of who have done the SCT payment
USE CASE Mr. Sender
debtorIBAN
String
The iban of who have done the SCT payment
USE CASE IT04G0306901000XTESTXCASEX1
creditorName
String
Name of who received the payment
USE CASE Mr. Receiver
creditorIBAN
String
The iban of who received the payment
USE CASE IT94H0306901000XTESTXCASEX2
amount
Double
Transfer amount
USE CASE 450,00
Currency
String
Currency of the payment
USE CASE EUR
paymentInformation
String
Description of the transfer
USE CASE SCT payment
requestedExecutionDate
String
Execution date of the payment
USE CASE 13/01/2022
endToEndId
String
identifier of the payment made of two information a unique identifier assigned to the statement by the sender towards his bank and URI identifier assigned by the sender
USE CASE 02INTER20180222HSRT1540602965
categoryPurpose
String
Category purpose code of the Credit Transfer
Response
success
Boolean
indicates if the request is ok or ko
USE CASE true
errors
String
USE CASE null
payload.customerCRO
String
Unique identifier of the payment
USE CASE 0306939633779105481110053100IT
payload.paymentId
String
Unique identifier of the payment, a transfert can be identifier by customerCRO or paymentId
USE CASE BS200232201369726106952M4
payload.transactionStatusDescription
String
description of the payment's transaction status
USE CASE Accepted
payload.paymentStatus
String
Status of the transfer execution
USE CASE ACSP
payload.creditorBic
String
unique identifier for creditor's financial institution
USE CASE BCITITMMXXX
payload.creditorAgent
String
The creditor agent
payload.commissioni
Double
Transfer fees
USE CASE 0.9
payload.executionDate
String
The date on which the execution of the payment occurred
USE CASE 02/01/2022
payload.valueDate
String
The value date used for the execution of the payment
USE CASE 01/01/2022
payload.settlementDate
String
The settlement date planned for the execution of the payment
USE CASE 03/01/2022
payload.revokeDate
String
The date on which the execution of the payment occurred
USE CASE 03/01/2022
payload.revokeTime
String
The time on which the execution of the payment occurred
USE CASE 17:30:00
Response example
json
{
"success": true,
"error": null,
"payload": {
"customerCro": "0306939633779105481110053100IT",
"paymentId": "BS200232201369726106952M4",
"transactionStatusDescription": "Accepted",
"paymentStatus": "ACSP",
"creditorBic": "BCITITMMXXX",
"creditorAgent": “”
“commissioni”: “0.9”
“executionDate”: “02/01/2022”
“valueDate”: “01/01/2022”
“settlementDate”: “03/01/2022”
“revokeDate”: “03/01/2022”
“revokeTime”: “17:30:00”
}
}