API SCT Inst
L’integrazione delle funzionalità all’interno del tuo gestionale ti permette di disporre un bonifico istantaneo in euro (SCT Inst) 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 Inst 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
- Inoltre, potrai richiamare la lista pagamenti istantanei disposti negli ultimi 18 mesi con l’API Payment List
I rapporti collegabili a questa API sono conti correnti in Euro e in divisa estera aperti presso filiali di Intesa Sanpaolo SPA.
Il set di caratteri ammesso per l'utilizzo di questa API è Latin:
a b c d e f g h i j k l m n o p q r s t u v w x y z
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
0 1 2 3 4 5 6 7 8 9
/ - ? : ( ) . , ' + Space
*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.
Nota: per i pagamenti il cui esito è "verify", è possibile controllarne l'effettiva esecuzione verificando dopo 10 minuti che siano presenti nella lista dei pagamenti istantanei
Request
debtorName
String
The name of who have done the instant payment
USE CASE Mr. Sender
debtorIBAN
String
The iban of who have done the instant 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
paymentInformation
String
Description of the transfert
USE CASE SCT instant payment
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, example 02INTER20180222HSRT1540602965.
siaCode
String
Identification code of the company that subscived the Interbank Corporate Banking (CBI) contract
Authorization
String
Header tag containing the OAuth 2 access token
Response
success
Boolean
USE CASE true
error
Object
USE CASE null
payload.orderId
String
Unique identifier of the payment
USE CASE 0306921762315103480100101001IT
payload.paymentId
String
Unique identifier of the payment, a transfert can be identifier by orderId or paymentId.
USE CASE 0304161762528507440100001000IT
payload.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, example 02INTER20180222HSRT1540602965.
USE CASE NOT PROVIDED
payload.customerCro
String
unique payment's identifier
USE CASE 1803153714600096
payload.transactionStatusDescription
String
description of the payment's transaction status
USE CASE ACSC-Prtry:
payload.paymentStatus
String
Status of the transfert
USE CASE ACSC
payload.amount
Double
Transfer amount
USE CASE 450.00
payload.currency
String
currency of the amount
USE CASE EUR
payload.date
String
The date-time on which the payment occurred.
USE CASE 2017-12-31T23:59:60Z
payload.categoryPurpose
String
payment's purpose
USE CASE CASH
payload.paymentInformation
String
Description of the transfert
USE CASE SCT instant payment
payload.debtorName
String
The name of who have done the instant payment
USE CASE Mr. Sender
payload.debtorIBAN
String
The iban of who have done the instant payment
USE CASE IT04G0306901000XTESTXCASEX1
payload.debtorBic
String
unique identifier for debtor's financial institution
USE CASE BCITITMMXXX
payload.ultimateDebtorName
String
The name of ultimate debtor
USE CASE null
payload.creditorName
String
Name of who received the payment
USE CASE Mr. Receiver
payload.creditorIBAN
String
The iban of who received the payment
USE CASE IT94H0306901000XTESTXCASEX2
payload.creditorBic
String
unique identifier for creditor's financial institution
USE CASE BCITITMMXXX
payload.ultimateCreditorName
String
The name of ultimate creditor
USE CASE null
Response example
json
{
"success": true,
"error": null,
"payload": {
"orderId": "0306921762315103480100101001IT",
"paymentId": "0304161762528507440100001000IT",
"endToEndId": "NOT PROVIDED",
"customerCro": "1803153714600096",
"transactionStatusDescription": "ACSC-Prtry:",
"paymentStatus": "ACSC",
"amount": "450.00",
"currency": "EUR",
"date": "2017-12-31T23:59:60Z",
"categoryPurpose": "CASH",
"paymentInformation": "SCT instant payment",
"debtorName": "Mr. Sender",
"debtorIBAN": "IT04G0306901000XTESTXCASEX1",
"debtorBic": "BCITITMMXXX",
"ultimateDebtorName": null,
"creditorName": "Mr. Receiver",
"creditorIBAN": "IT94H0306901000XTESTXCASEX2",
"creditorBic": "BCITITMMXXX",
"ultimateCreditorName": null
}
}