Webhooks : avertir votre système à chaque paiement

Un webhook est un message automatique que 1pay.ch envoie à votre système quand quelque chose se produit : un paiement confirmé, un abonnement renouvelé, un versement qui part. Ainsi, votre boutique ou votre logiciel de gestion se met à jour tout seul, sans contrôles manuels.

Si vous utilisez le plugin WooCommerce, suivez ses instructions : le webhook nécessaire y est déjà prévu.

Créer un webhook #

1. Dans le menu, ouvrez Webhooks et cliquez sur l’option d’ajout d’un webhook.
2. Nom (facultatif) : un nom pour le reconnaître, par exemple «Logiciel de gestion».
3. URL du webhook : l’adresse de votre système qui reçoit les messages. Copiez-la exactement, avec https.
4. Type de webhook : Normal (PHP-Post) ou JSON, selon ce que demande votre système.
5. Version du webhook : celle indiquée dans les instructions de votre système ou par votre développeur.
6. Réessayer en cas d’erreur : activez-le seulement si votre système le demande.
7. Événements : choisissez quand envoyer le message :
   • Transaction : quand un paiement est créé ou que son statut change ;
   • Subscription : quand il se passe quelque chose d’important pour un abonnement ;
   • Payout : quand un versement part vers votre compte.
8. Lien vers l’intégration (facultatif) : relie le webhook à une seule clé API, pour qu’il ne reçoive que les événements créés avec cette clé. Sans intégration, il reçoit tous les événements.
9. Cliquez sur Ajouter.

Sécurité #

Chaque webhook a sa propre signature secrète, envoyée avec chaque message. Votre système peut la contrôler pour s’assurer que le message vient bien de 1pay.ch. Votre développeur sait comment l’utiliser.

Contact technique #

Sur la même page, indiquez le nom et l’e-mail du contact technique : il reçoit les alertes quand un webhook ou une requête API échoue.

Si quelque chose ne fonctionne pas #

Sous Log, vous voyez chaque message envoyé et la réponse de votre système. Les causes les plus fréquentes :

• l’URL n’est pas écrite exactement comme le veut votre système (une barre oblique en trop, http au lieu de https) ;
• le format ou la version choisis ne correspondent pas à ce qui est attendu ;
• votre serveur refuse ou bloque la requête.

Si vous ne trouvez pas le problème, écrivez-nous avec le nom de votre compte et l’heure du paiement concerné.