Skip to main content

API PISP – Documentazione Tecnica

View as Markdown

Le API PISP consentono l’inizializzazione, la consultazione e il monitoraggio dei pagamenti eseguiti tramite la XS2A interface. 

1. Flussi PISP Supportati​

Il TPP può:

  • Inizializzare un pagamento SEPA (single, bulk o recurring)

  • Recuperare lo stato del pagamento

  • Ottenere i dettagli del pagamento 

2. Endpoint principali​

2.1 Inizializzazione pagamento​

POST /payments/{payment-product} 

Crea un payment resource associato a un paymentId. 

Parametri tipici:

  • debtorAccount

  • creditorAccount

  • amount

  • remittanceInformation

2.2 Dettaglio pagamento​

GET /payments/{payment-product}/{paymentId} 

Legge i dettagli di un pagamento già iniziato. 

2.3 Stato pagamento​

GET /payments/{payment-product}/{paymentId}/status 

Restituisce lo stato dell’operazione. 

3. Bulk Payments​

Supportati tramite:

  • POST /bulk-payments/{payment-product}

  • GET /bulk-payments/{payment-product}/{paymentId}

  • GET /bulk-payments/{payment-product}/{paymentId}/status 

4. Strong Customer Authentication (SCA)​

Le modalità supportate dal Berlin Group e quindi dal Gateway Fabrick:

  • Redirect

  • OAuth2 Redirect

  • Decoupled

  • Embedded 

Il TPP può indicare una preferenza nella richiesta di pagamento.

5. Note di implementazione​

  • Il supporto ai prodotti di pagamento dipende dalla banca (ASPSP).

  • SCA non è necessaria per lettura dettagli o stato pagamento.

  • Endpoint uniformati allo standard Berlin Group.

Standard di riferimento​

Berlin Group NextGenPSD2 – Payment Initiation.