Home I webhook consentono di notificare alla vostra applicazione i cambiamenti di stato delle entità, come le transazioni di pagamento o gli abbonamenti. Sebbene i webhook possano essere utilizzati per molti scopi, sono particolarmente importanti quando si utilizzano gli abbonamenti, dove la maggior parte dell’attività avviene in modo asincrono e dietro le quinte.
Il nostro concetto è che gestiamo tutto noi e l’unica cosa di cui dovete occuparvi è attivare, sospendere e terminare il servizio dalla vostra parte. Ciò significa che dovreste reagire in base ai cambiamenti di stato degli abbonamenti. I webhook sono il modo più semplice per farlo, perché vi informano automaticamente quando è necessaria una modifica dalla vostra parte.
Prima di tutto, date un’occhiata alla nostra guida generale ai webhook. Di seguito trovate informazioni aggiuntive sull’utilizzo dei webhook con gli abbonamenti.
Un pagamento fallito può essere un problema temporaneo (la banca ha rifiutato questo addebito ma potrebbe consentire il nuovo tentativo automatico) oppure indicare un blocco permanente, come la mancanza di una fonte di pagamento utilizzabile. Questo avviene automaticamente quando utilizzate i charge flow. Lì potete anche specificare come contattiamo l’abbonato.
Se avete attivato l’opzione Email Delivery sul prodotto, informiamo il cliente anche dei cambiamenti di stato dell’abbonamento stesso. Ciò significa che inviamo e-mail relative alla terminazione di un abbonamento o alla sospensione di un abbonamento.
Se preferite informare l’abbonato voi stessi, potete reagire ai corrispondenti cambiamenti di stato dell’abbonamento.
Gli abbonamenti richiedono più coordinamento tra la vostra applicazione e la nostra piattaforma rispetto ai pagamenti singoli. Nel modello di abbonamento, l’accesso continuativo di un cliente al vostro prodotto o servizio è determinato dal successo o dal fallimento di pagamenti automatici e ricorrenti. Prendete, ad esempio, un sito in cui un abbonamento fornisce l’accesso ai contenuti del sito.
Verrete notificati quando un abbonamento è active, suspended o terminated. Esistono altri stati
dell’abbonamento. Tuttavia, i tre stati menzionati sono quelli rilevanti a cui dovreste reagire.
-
activesignifica che l’abbonamento è attivo e che anche il servizio dalla vostra parte dovrebbe essere attivato. -
suspendedsignifica che l’abbonamento dalla vostra parte dovrebbe essere messo in pausa (ossia, se fornite video ai vostri abbonati, dovreste impedire loro di vedere i film non appena ricevete questo stato nella chiamata webhook. Tuttavia, potreste voler consentire loro di accedere al vostro sistema, perché potreste voler informarli che l’abbonamento è stato sospeso). -
terminatedsignifica che l’abbonamento non viene più fatturato e che quindi il servizio dovrebbe essere interrotto in modo permanente. Ad esempio, questo è il segnale per chiudere l’account nel vostro sistema.