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.
    (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)

POST

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

    }

}