Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Effettuando la sottoscrizione alle notifiche Webhook, si ricevono notifiche sul proprio sistema quando viene creata o aggiornata una transazione nel gateway. Ciò consente di aggiornare il sistema del sito Web di conseguenza. La notifica Webhook contiene la risposta dell'operazione Retrieve Transaction.
Per le integrazioni Hosted Checkout, se si utilizza l'API di autenticazione per l'autenticazione 3D Secure, si riceveranno due notifiche Webhook, rispetto a una se si utilizza la funzionalità 3DS1.
Il Webhook di autenticazione del pagante includerà solo i dettagli dell'operazione di autenticazione. Non includerà informazioni sull'esito della transazione finanziaria. Il Webhook Authorization/Pay includerà l'esito dell'elaborazione della transazione finanziaria.
È possibile configurare i seguenti parametri per le notifiche Webhook in Merchant Administration:
order.notificationUrl
nella richiesta di transazione. Per le transazioni successive, le notifiche vengono inviate all'URL riportato sulla transazione (se fornito) o all'ultimo URL utilizzato per l'ordine.Se ci si basa sul contenuto della notifica Webhook per motivi aziendali critici, è consigliabile effettuare i passaggi illustrati di seguito per garantire l'integrità dei dati ricevuti nelle notifiche.
In alternativa, è possibile eseguire un'operazione Retrieve Transaction utilizzando gli identificativi nella notifica ricevuta per ottenere i dettagli modificati.
Il gateway considera la consegna della notifica webhook come riuscita se il sistema risponde con un messaggio di riscontro contenente il codice di stato HTTP 200 entro 2 secondi.
Il gateway prova a inviare le notifiche nella stessa sequenza con cui si sono verificati gli aggiornamenti alle transazioni, a meno che la notifica non richieda una nuova consegna. La nuova consegna si verifica quando la consegna della notifica iniziale non riesce o il messaggio di riscontro non viene ricevuto. In questi casi, il gateway prova a inviare di nuovo le notifiche fino a 20 volte nei 3 giorni successivi all'evento. Può pertanto accadere che vengano inviate notifiche duplicate al sistema. Per gestire le notifiche riconsegnate, è possibile utilizzare i campi seguenti nella notifica Webhook: