{"id":8930,"date":"2026-10-20T09:32:00","date_gmt":"2026-10-20T07:32:00","guid":{"rendered":"https:\/\/www.1pay.ch\/docs\/webhooks-notifications\/"},"modified":"2026-11-06T09:21:35","modified_gmt":"2026-11-06T08:21:35","password":"","slug":"webhooks-notifications","status":"publish","type":"docs","link":"https:\/\/www.1pay.ch\/fr\/docs\/webhooks-notifications\/","title":{"rendered":"Webhooks : avertir votre syst\u00e8me \u00e0 chaque paiement"},"content":{"rendered":"

Un webhook est un message automatique que 1pay.ch envoie \u00e0 votre syst\u00e8me quand quelque chose se produit : un paiement confirm\u00e9, un abonnement renouvel\u00e9, un versement qui part. Ainsi, votre boutique ou votre logiciel de gestion se met \u00e0 jour tout seul, sans contr\u00f4les manuels.<\/p>\n

Si vous utilisez le plugin WooCommerce<\/a>, suivez ses instructions : le webhook n\u00e9cessaire y est d\u00e9j\u00e0 pr\u00e9vu.<\/p>\n

Cr\u00e9er un webhook<\/h2>\n
    \n
  1. Dans le menu, ouvrez Webhooks<\/strong> et cliquez sur l’option d’ajout d’un webhook.<\/li>\n
  2. Nom (facultatif)<\/strong> : un nom pour le reconna\u00eetre, par exemple \u00abLogiciel de gestion\u00bb.<\/li>\n
  3. URL du webhook<\/strong> : l’adresse de votre syst\u00e8me qui re\u00e7oit les messages. Copiez-la exactement, avec https<\/code>.<\/li>\n
  4. Type de webhook<\/strong> : Normal (PHP-Post) ou JSON, selon ce que demande votre syst\u00e8me.<\/li>\n
  5. Version du webhook<\/strong> : celle indiqu\u00e9e dans les instructions de votre syst\u00e8me ou par votre d\u00e9veloppeur.<\/li>\n
  6. R\u00e9essayer en cas d’erreur<\/strong> : activez-le seulement si votre syst\u00e8me le demande.<\/li>\n
  7. \u00c9v\u00e9nements<\/strong> : choisissez quand envoyer le message :\n
      \n
    • Transaction<\/strong> : quand un paiement est cr\u00e9\u00e9 ou que son statut change ;<\/li>\n
    • Subscription<\/strong> : quand il se passe quelque chose d’important pour un abonnement ;<\/li>\n
    • Payout<\/strong> : quand un versement part vers votre compte.<\/li>\n<\/ul>\n<\/li>\n
    • Lien vers l’int\u00e9gration (facultatif)<\/strong> : relie le webhook \u00e0 une seule cl\u00e9 API, pour qu’il ne re\u00e7oive que les \u00e9v\u00e9nements cr\u00e9\u00e9s avec cette cl\u00e9. Sans int\u00e9gration, il re\u00e7oit tous les \u00e9v\u00e9nements.<\/li>\n
    • Cliquez sur Ajouter<\/strong>.<\/li>\n<\/ol>\n

      S\u00e9curit\u00e9<\/h2>\n

      Chaque webhook a sa propre signature secr\u00e8te, envoy\u00e9e avec chaque message. Votre syst\u00e8me peut la contr\u00f4ler pour s’assurer que le message vient bien de 1pay.ch. Votre d\u00e9veloppeur sait comment l’utiliser.<\/p>\n

      Contact technique<\/h2>\n

      Sur la m\u00eame page, indiquez le nom et l’e-mail du contact technique<\/strong> : il re\u00e7oit les alertes quand un webhook ou une requ\u00eate API \u00e9choue.<\/p>\n

      Si quelque chose ne fonctionne pas<\/h2>\n

      Sous Log<\/strong>, vous voyez chaque message envoy\u00e9 et la r\u00e9ponse de votre syst\u00e8me. Les causes les plus fr\u00e9quentes :<\/p>\n

        \n
      • l’URL n’est pas \u00e9crite exactement comme le veut votre syst\u00e8me (une barre oblique en trop, http<\/code> au lieu de https<\/code>) ;<\/li>\n
      • le format ou la version choisis ne correspondent pas \u00e0 ce qui est attendu ;<\/li>\n
      • votre serveur refuse ou bloque la requ\u00eate.<\/li>\n<\/ul>\n

        Si vous ne trouvez pas le probl\u00e8me, \u00e9crivez-nous avec le nom de votre compte et l’heure du paiement concern\u00e9.<\/p>\n","protected":false},"excerpt":{"rendered":"

        Un webhook est un message automatique que 1pay.ch envoie \u00e0 votre syst\u00e8me quand quelque chose se produit : un paiement confirm\u00e9, un abonnement renouvel\u00e9, un versement qui part. Ainsi, votre boutique ou votre logiciel de gestion se met \u00e0 jour tout seul, sans contr\u00f4les manuels. Si vous utilisez le plugin WooCommerce, suivez ses instructions : […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_category":[213],"doc_tag":[],"class_list":["post-8930","docs","type-docs","status-publish","hentry","doc_category-integrations-1pay"],"acf":[],"year_month":"2026-11","word_count":387,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"1pay.ch","author_nicename":"1pay_admin","author_url":"https:\/\/www.1pay.ch\/fr\/author\/1pay_admin\/"},"doc_category_info":[{"term_name":"Int\u00e9grations","term_url":"https:\/\/www.1pay.ch\/fr\/docs-category\/integrations-1pay\/"}],"doc_tag_info":[],"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/www.1pay.ch\/fr\/wp-json\/wp\/v2\/docs\/8930","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.1pay.ch\/fr\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.1pay.ch\/fr\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.1pay.ch\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.1pay.ch\/fr\/wp-json\/wp\/v2\/comments?post=8930"}],"version-history":[{"count":7,"href":"https:\/\/www.1pay.ch\/fr\/wp-json\/wp\/v2\/docs\/8930\/revisions"}],"predecessor-version":[{"id":9841,"href":"https:\/\/www.1pay.ch\/fr\/wp-json\/wp\/v2\/docs\/8930\/revisions\/9841"}],"wp:attachment":[{"href":"https:\/\/www.1pay.ch\/fr\/wp-json\/wp\/v2\/media?parent=8930"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.1pay.ch\/fr\/wp-json\/wp\/v2\/doc_category?post=8930"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.1pay.ch\/fr\/wp-json\/wp\/v2\/doc_tag?post=8930"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}