Un webhook è un messaggio automatico che 1pay.ch manda al tuo sistema quando succede qualcosa: un pagamento confermato, un abbonamento rinnovato, un versamento partito. Così il tuo negozio o gestionale si aggiorna da solo, senza controlli manuali.

Se usi il plugin WooCommerce, segui le sue istruzioni: il webhook necessario è già previsto lì.

Creare un webhook #

1. Nel menu apri Webhooks e clicca Aggiungere webhook.
2. Nome (opzionale): un nome per riconoscerlo, per esempio «Gestionale».
3. URL Webhook: l’indirizzo del tuo sistema che riceve i messaggi. Copialo esattamente, con https.
4. Tipo Webhook: Normale (PHP-Post) o JSON, come richiesto dal tuo sistema.
5. Versione Webhook: quella indicata nelle istruzioni del tuo sistema o dal tuo sviluppatore.
6. Riprovare in caso di errore: attivalo solo se il tuo sistema lo richiede.
7. Eventi: scegli quando inviare il messaggio:
   • Transaction: quando nasce un pagamento o ne cambia lo stato;
   • Subscription: quando succede qualcosa di importante a un abbonamento;
   • Payout: quando parte un versamento verso il tuo conto.
8. Link all’integrazione (opzionale): collega il webhook a una sola chiave API, così riceve solo gli eventi creati con quella chiave. Con «Nessuna integrazione» riceve tutti gli eventi.
9. Clicca Aggiungere.

Sicurezza #

Ogni webhook ha una sua firma segreta che viene inviata con ogni messaggio. Il tuo sistema può controllarla per essere sicuro che il messaggio arrivi davvero da 1pay.ch. Il tuo sviluppatore sa come usarla.

Contatto tecnico #

Nella stessa pagina indica nome ed e-mail del Contatto tecnico: riceve gli avvisi quando un webhook o una richiesta API non va a buon fine.

Se qualcosa non funziona #

Con Log vedi ogni messaggio inviato e la risposta del tuo sistema. Le cause più comuni:

• l’URL non è scritto esattamente come lo vuole il tuo sistema (una barra in più, http invece di https);
• il formato o la versione scelti non corrispondono a quelli attesi;
• il tuo server rifiuta o blocca la richiesta.

Se non trovi il problema, scrivici con il nome del tuo conto e l’ora del pagamento interessato.