{"id":11960,"date":"2023-08-05T09:02:08","date_gmt":"2023-08-05T09:02:08","guid":{"rendered":"https:\/\/wooshpay.com\/?post_type=docs&p=11960"},"modified":"2023-08-09T07:32:19","modified_gmt":"2023-08-09T07:32:19","password":"","slug":"webhooks","status":"publish","type":"docs","link":"https:\/\/wooshpay.com\/fr\/docs\/webhooks\/","title":{"rendered":"Crochet Web"},"content":{"rendered":"

WooshPay Webhooks<\/h2>\n\n\n\n

WooshPay uses webhooks to notify your application when an event happens in your account. Webhooks are particularly useful for asynchronous events like when a customer\u2019s bank confirms a payment, a customer disputes a charge, or when collecting subscription payments. You can configure webhook endpoints via the API to be notified about events.<\/p>\n\n\n\n

Steps to Create and Receive Webhooks<\/h2>\n\n\n\n

You can start receiving event notifications in your app using the steps in this section:<\/p>\n\n\n\n

    \n
  1. Identify the events you want to monitor and the events<\/a> payloads to parse.<\/li>\n\n\n\n
  2. Cr\u00e9ez un point de terminaison webhook en tant que point de terminaison HTTP (URL) sur votre serveur local.<\/li>\n\n\n\n
  3. Handle requests from WooshPay by parsing each event object and returning 2xx<\/code><\/strong> response status codes.<\/li>\n\n\n\n
  4. Deploy your webhook endpoint so it\u2019s a publicly accessible HTTPS URL.<\/li>\n\n\n\n
  5. Register your publicly accessible HTTPS URL by webhook object.<\/li>\n<\/ol>\n\n\n\n

    How to create a webhook endpoint<\/h3>\n\n\n\n

    Creating a webhook endpoint is no different from creating any other page on your website. It\u2019s an HTTP or HTTPS endpoint on your server with a URL. If you\u2019re still developing your endpoint on your local machine, it can be HTTP. After it\u2019s publicly accessible, it must be HTTPS.<\/p>\n\n\n\n

    Step 1. Identify the events to monitor<\/h3>\n\n\n\n

    Use the API reference guide to identify the Wooshpay events and their event objects your webhook endpoint needs to parse.<\/p>\n\n\n\n

    Step 2: Cr\u00e9er un webhook<\/a><\/h3>\n\n\n\n

    Set up an HTTP endpoint on your local machine that can accept unauthenticated webhook requests with a POST method.<\/p>\n\n\n\n

    Demande<\/em><\/strong><\/p>\n\n\n\n

    {\n    \"url\": \"https:\/\/apitest.wooshpay.com\/v1\/receives\",\n    \"description\": \"I am description\",\n    \"enabled_events\": [\n        \"payment_intent.created\",\n        \"payment_intent.payment_failed\",\n        \"payment_intent.requires_action\",\n        \"payment_intent.succeeded\",\n        \"payment_intent.canceled\",\n        \"charge.refund.updated\"\n    ],\n    \"api_version\": \"1.0.1\"\n}<\/code><\/pre>\n\n\n\n
    R\u00e9ponse<\/em><\/strong><\/p>\n\n\n\n
    {\n    \"id\": \"we_1600745739909070848\",\n    \"object\": \"webhook_endpoint\",\n    \"created\": 1670482499000,\n    \"description\": \"I am description\",\n    \"metadata\": null,\n    \"secret\": \"c2tfdGVzdF9kR1Z6ZERwMFpYTjBNVEl6TkRVMjo=\",\n    \"status\": \"enabled\",\n    \"url\": \"https:\/\/apitest.wooshpay.com\/v1\/receives\",\n    \"livemode\": false,\n    \"api_version\": \"1.0.1\",\n    \"enabled_events\": [\n        \"payment_intent.created\",\n        \"payment_intent.payment_failed\",\n        \"payment_intent.requires_action\",\n        \"payment_intent.succeeded\",\n        \"payment_intent.canceled\",\n        \"charge.refund.updated\"\n    ]\n}<\/code><\/pre>\n\n\n\n
    Step 3: Handle requests from WooshPay<\/h3>\n\n\n\n
    Your endpoint must be configured to read event objects for the type of event notifications you want to receive. WooshPay sends events to your webhook endpoint as part of a POST request with a JSON payload.<\/p>\n\n\n\n
    Return a 2xx response<\/strong>
    Your endpoint must quickly return a successful status code (2xx) prior to any complex logic that could cause a timeout.<\/p>\n\n\n\n
    Delivery attempts and retries<\/h2>\n\n\n\n
    Understand how to view delivery attempts, event logs, and the retry logic when webhook events aren\u2019t acknowledged.<\/p>\n\n\n\n
    Retry logic<\/strong>
    In live and test mode, WooshPay attempts to deliver your webhooks for up to three days with an exponential back off, which means in total we will deliver 18 times in 72 hours.<\/p>\n\n\n\n
    Pending Webhook logic<\/strong>
    In live and test mode, WooshPay will attempt to notify you of any unsuccessful webhooks via email if an endpoint has not responded with a 2xx HTTP status code. The email will not only tell you the URL that cannot be delivered, but also when we will stop deliver the webhooks, and also the best way for you to reach us.<\/p>","protected":false},"excerpt":{"rendered":"
    WooshPay Webhooks WooshPay uses webhooks to notify your application when an event happens in your account. Webhooks are particularly useful for asynchronous events like when a customer\u2019s bank confirms a payment, a customer disputes a charge, or when collecting subscription payments. You can configure webhook endpoints via the API to be notified about events. Steps […]<\/p>","protected":false},"author":6,"featured_media":17289,"comment_status":"open","ping_status":"closed","template":"","meta":{"_uag_custom_page_level_css":"","footnotes":""},"doc_category":[316],"doc_tag":[324,323,319,328],"class_list":["post-11960","docs","type-docs","status-publish","has-post-thumbnail","hentry","doc_category-after-the-payments","doc_tag-open-api","doc_tag-payment","doc_tag-payment-flow","doc_tag-webhhoks"],"year_month":"2026-04","word_count":519,"total_views":"2234","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"zhaozixu","author_nicename":"zhaozixu","author_url":"https:\/\/wooshpay.com\/fr\/author\/zhaozixu\/"},"doc_category_info":[{"term_name":"After the payments","term_url":"https:\/\/wooshpay.com\/fr\/docs-category\/after-the-payments\/"}],"doc_tag_info":[{"term_name":"open api","term_url":"https:\/\/wooshpay.com\/fr\/docs-tag\/open-api\/"},{"term_name":"payment","term_url":"https:\/\/wooshpay.com\/fr\/docs-tag\/payment\/"},{"term_name":"Payment Flow","term_url":"https:\/\/wooshpay.com\/fr\/docs-tag\/payment-flow\/"},{"term_name":"webhhoks","term_url":"https:\/\/wooshpay.com\/fr\/docs-tag\/webhhoks\/"}],"yoast_head":"\nWebhook - WooshPay<\/title>\n<meta name=\"description\" content=\"WooshPay uses webhooks to notify your application when an event happens in your account. Webhooks are particularly useful for asynchronous events like when a customer\u2019s bank confirms a payment, a customer disputes a charge, or when collecting subscription payments. You can configure webhook endpoints via the API to be notified about events.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/wooshpay.com\/fr\/docs\/webhooks\/\" \/>\n<meta property=\"og:locale\" content=\"fr_FR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Webhook\" \/>\n<meta property=\"og:description\" content=\"WooshPay uses webhooks to notify your application when an event happens in your account. Webhooks are particularly useful for asynchronous events like when a customer\u2019s bank confirms a payment, a customer disputes a charge, or when collecting subscription payments. You can configure webhook endpoints via the API to be notified about events.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/wooshpay.com\/fr\/docs\/webhooks\/\" \/>\n<meta property=\"og:site_name\" content=\"WooshPay\" \/>\n<meta property=\"article:modified_time\" content=\"2023-08-09T07:32:19+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2.png\" \/>\n\t<meta property=\"og:image:width\" content=\"2138\" \/>\n\t<meta property=\"og:image:height\" content=\"1438\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/\",\"url\":\"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/\",\"name\":\"Webhook - WooshPay\",\"isPartOf\":{\"@id\":\"https:\/\/wooshpay.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2.png\",\"datePublished\":\"2023-08-05T09:02:08+00:00\",\"dateModified\":\"2023-08-09T07:32:19+00:00\",\"description\":\"WooshPay uses webhooks to notify your application when an event happens in your account. Webhooks are particularly useful for asynchronous events like when a customer\u2019s bank confirms a payment, a customer disputes a charge, or when collecting subscription payments. You can configure webhook endpoints via the API to be notified about events.\",\"breadcrumb\":{\"@id\":\"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/#breadcrumb\"},\"inLanguage\":\"fr-FR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"fr-FR\",\"@id\":\"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/#primaryimage\",\"url\":\"https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2.png\",\"contentUrl\":\"https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2.png\",\"width\":2138,\"height\":1438},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/wooshpay.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Docs\",\"item\":\"https:\/\/wooshpay.com\/ja\/docs\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Webhook\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/wooshpay.com\/#website\",\"url\":\"https:\/\/wooshpay.com\/\",\"name\":\"WooshPay\",\"description\":\"One-stop payment platform\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/wooshpay.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"fr-FR\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Webhook - WooshPay","description":"WooshPay uses webhooks to notify your application when an event happens in your account. Webhooks are particularly useful for asynchronous events like when a customer\u2019s bank confirms a payment, a customer disputes a charge, or when collecting subscription payments. You can configure webhook endpoints via the API to be notified about events.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/wooshpay.com\/fr\/docs\/webhooks\/","og_locale":"fr_FR","og_type":"article","og_title":"Webhook","og_description":"WooshPay uses webhooks to notify your application when an event happens in your account. Webhooks are particularly useful for asynchronous events like when a customer\u2019s bank confirms a payment, a customer disputes a charge, or when collecting subscription payments. You can configure webhook endpoints via the API to be notified about events.","og_url":"https:\/\/wooshpay.com\/fr\/docs\/webhooks\/","og_site_name":"WooshPay","article_modified_time":"2023-08-09T07:32:19+00:00","og_image":[{"width":2138,"height":1438,"url":"https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/","url":"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/","name":"Webhook - WooshPay","isPartOf":{"@id":"https:\/\/wooshpay.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/#primaryimage"},"image":{"@id":"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/#primaryimage"},"thumbnailUrl":"https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2.png","datePublished":"2023-08-05T09:02:08+00:00","dateModified":"2023-08-09T07:32:19+00:00","description":"WooshPay uses webhooks to notify your application when an event happens in your account. Webhooks are particularly useful for asynchronous events like when a customer\u2019s bank confirms a payment, a customer disputes a charge, or when collecting subscription payments. You can configure webhook endpoints via the API to be notified about events.","breadcrumb":{"@id":"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/#breadcrumb"},"inLanguage":"fr-FR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/wooshpay.com\/ja\/docs\/webhooks\/"]}]},{"@type":"ImageObject","inLanguage":"fr-FR","@id":"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/#primaryimage","url":"https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2.png","contentUrl":"https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2.png","width":2138,"height":1438},{"@type":"BreadcrumbList","@id":"https:\/\/wooshpay.com\/ja\/docs\/webhooks\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/wooshpay.com\/"},{"@type":"ListItem","position":2,"name":"Docs","item":"https:\/\/wooshpay.com\/ja\/docs\/"},{"@type":"ListItem","position":3,"name":"Webhook"}]},{"@type":"WebSite","@id":"https:\/\/wooshpay.com\/#website","url":"https:\/\/wooshpay.com\/","name":"WooshPay","description":"Plate-forme de paiement unique","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/wooshpay.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"fr-FR"}]}},"uagb_featured_image_src":{"full":["https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2.png",2138,1438,false],"thumbnail":["https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2-150x150.png",150,150,true],"medium":["https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2-300x202.png",300,202,true],"medium_large":["https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2-768x517.png",768,517,true],"large":["https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2-1024x689.png",1024,689,true],"1536x1536":["https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2-1536x1033.png",1536,1033,true],"2048x2048":["https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2-2048x1377.png",2048,1377,true],"trp-custom-language-flag":["https:\/\/wooshpay-official-img.oss-accelerate.aliyuncs.com\/wp-content\/uploads\/2024\/07\/pic_home_new-2-18x12.png",18,12,true]},"uagb_author_info":{"display_name":"zhaozixu","author_link":"https:\/\/wooshpay.com\/fr\/author\/zhaozixu\/"},"uagb_comment_info":0,"uagb_excerpt":"WooshPay Webhooks WooshPay uses webhooks to notify your application when an event happens in your account. Webhooks are particularly useful for asynchronous events like when a customer\u2019s bank confirms a payment, a customer disputes a charge, or when collecting subscription payments. You can configure webhook endpoints via the API to be notified about events. Steps\u2026","_links":{"self":[{"href":"https:\/\/wooshpay.com\/fr\/wp-json\/wp\/v2\/docs\/11960","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wooshpay.com\/fr\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/wooshpay.com\/fr\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/wooshpay.com\/fr\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/wooshpay.com\/fr\/wp-json\/wp\/v2\/comments?post=11960"}],"version-history":[{"count":0,"href":"https:\/\/wooshpay.com\/fr\/wp-json\/wp\/v2\/docs\/11960\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wooshpay.com\/fr\/wp-json\/wp\/v2\/media\/17289"}],"wp:attachment":[{"href":"https:\/\/wooshpay.com\/fr\/wp-json\/wp\/v2\/media?parent=11960"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/wooshpay.com\/fr\/wp-json\/wp\/v2\/doc_category?post=11960"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/wooshpay.com\/fr\/wp-json\/wp\/v2\/doc_tag?post=11960"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}