{"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:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/docs\/webhooks\/","title":{"rendered":"Webhook"},"content":{"rendered":"

Ganci web WooshPay<\/h2>\n\n\n\n

WooshPay utilizza i webhook per notificare alla vostra applicazione quando si verifica un evento nel vostro conto. I webhook sono particolarmente utili per gli eventi asincroni, come la conferma di un pagamento da parte della banca del cliente, la contestazione di un addebito da parte del cliente o la riscossione di pagamenti in abbonamento. \u00c8 possibile configurare gli endpoint dei webhook tramite l'API per ricevere la notifica degli eventi.<\/p>\n\n\n\n

Passi per la creazione e la ricezione di Webhooks<\/h2>\n\n\n\n

\u00c8 possibile iniziare a ricevere le notifiche degli eventi nella propria applicazione seguendo i passaggi indicati in questa sezione:<\/p>\n\n\n\n

    \n
  1. Identificare gli eventi che si desidera monitorare e il eventi<\/a> payload da analizzare.<\/li>\n\n\n\n
  2. Creare un endpoint webhook come endpoint HTTP (URL) sul server locale.<\/li>\n\n\n\n
  3. Gestire le richieste da parte dell'WooshPay analizzando ogni oggetto evento e restituendo 2xx<\/code><\/strong> codici di stato della risposta.<\/li>\n\n\n\n
  4. Distribuire l'endpoint del webhook in modo che sia un URL HTTPS accessibile pubblicamente.<\/li>\n\n\n\n
  5. Registrare l'URL HTTPS pubblicamente accessibile tramite l'oggetto webhook.<\/li>\n<\/ol>\n\n\n\n

    Come creare un endpoint webhook<\/h3>\n\n\n\n

    La creazione di un endpoint webhook non \u00e8 diversa dalla creazione di qualsiasi altra pagina del vostro sito web. Si tratta di un endpoint HTTP o HTTPS sul server con un URL. Se si sta ancora sviluppando l'endpoint sulla propria macchina locale, pu\u00f2 essere HTTP. Quando \u00e8 accessibile al pubblico, deve essere HTTPS.<\/p>\n\n\n\n

    Passo 1. Identificare gli eventi da monitorare<\/h3>\n\n\n\n

    Utilizzare la guida di riferimento dell'API per identificare gli eventi Wooshpay e i relativi oggetti evento che l'endpoint webhook deve analizzare.<\/p>\n\n\n\n

    Fase 2: Creare un webhook<\/a><\/h3>\n\n\n\n

    Impostare un endpoint HTTP sul computer locale che possa accettare richieste webhook non autenticate con metodo POST.<\/p>\n\n\n\n

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

    {\n    \"url\": \"https:\/\/apitest.wooshpay.com\/v1\/receives\",\n    \"descrizione\": \"Sono descrizione\",\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        \"addebito.rimborso.aggiornato\"\n    ],\n    \"api_version\": \"1.0.1\"\n}<\/code><\/pre>\n\n\n\n
    Risposta<\/em><\/strong><\/p>\n\n\n\n
    {\n    \"id\": \"we_1600745739909070848\",\n    \"oggetto\": \"webhook_endpoint\",\n    \"creato\": 1670482499000,\n    \"descrizione\": \"Sono descrizione\",\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        \"addebito.rimborso.aggiornato\"\n    ]\n}<\/code><\/pre>\n\n\n\n
    Fase 3: Gestione delle richieste da parte dell'WooshPay<\/h3>\n\n\n\n
    L'endpoint deve essere configurato per leggere gli oggetti evento per il tipo di notifiche evento che si desidera ricevere. L'WooshPay invia gli eventi all'endpoint webhook come parte di una richiesta POST con un payload JSON.<\/p>\n\n\n\n
    Restituzione di una risposta 2xx<\/strong>
    L'endpoint deve restituire rapidamente un codice di stato di successo (2xx) prima di qualsiasi logica complessa che possa causare un timeout.<\/p>\n\n\n\n
    Tentativi di consegna e ritentativi<\/h2>\n\n\n\n
    Capire come visualizzare i tentativi di consegna, i registri degli eventi e la logica di riprova quando gli eventi webhook non vengono riconosciuti.<\/p>\n\n\n\n
    Logica di ripetizione<\/strong>
    In modalit\u00e0 live e test, WooshPay tenta di consegnare i vostri webhook per un massimo di tre giorni con un back-off esponenziale, il che significa che in totale consegneremo 18 volte in 72 ore.<\/p>\n\n\n\n
    Logica dei webhook in attesa<\/strong>
    In modalit\u00e0 live e di prova, WooshPay cercher\u00e0 di notificare all'utente qualsiasi webhook non riuscito via e-mail se un endpoint non ha risposto con un codice di stato HTTP 2xx. L'e-mail non solo vi indicher\u00e0 l'URL che non pu\u00f2 essere consegnato, ma anche quando smetteremo di consegnare i webhook e il modo migliore per raggiungerci.<\/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:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/author\/zhaozixu\/"},"doc_category_info":[{"term_name":"After the payments","term_url":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/docs-category\/after-the-payments\/"}],"doc_tag_info":[{"term_name":"open api","term_url":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/docs-tag\/open-api\/"},{"term_name":"payment","term_url":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/docs-tag\/payment\/"},{"term_name":"Payment Flow","term_url":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/docs-tag\/payment-flow\/"},{"term_name":"webhhoks","term_url":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/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\/ko\/docs\/webhooks\/\" \/>\n<meta property=\"og:locale\" content=\"it_IT\" \/>\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\/ko\/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 minuti\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/wooshpay.com\/ko\/docs\/webhooks\/\",\"url\":\"https:\/\/wooshpay.com\/ko\/docs\/webhooks\/\",\"name\":\"Webhook - WooshPay\",\"isPartOf\":{\"@id\":\"https:\/\/www.wooshpay.com\/zh\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/wooshpay.com\/ko\/docs\/webhooks\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/wooshpay.com\/ko\/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\/ko\/docs\/webhooks\/#breadcrumb\"},\"inLanguage\":\"it-IT\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/wooshpay.com\/ko\/docs\/webhooks\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"it-IT\",\"@id\":\"https:\/\/wooshpay.com\/ko\/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\/ko\/docs\/webhooks\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.wooshpay.com\/zh\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Docs\",\"item\":\"https:\/\/wooshpay.com\/fr\/docs\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Webhook\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.wooshpay.com\/zh\/#website\",\"url\":\"https:\/\/www.wooshpay.com\/zh\/\",\"name\":\"WooshPay\",\"description\":\"One-stop payment platform\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.wooshpay.com\/zh\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"it-IT\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Webhook - WooshPay","description":"WooshPay utilizza i webhook per notificare alla vostra applicazione quando si verifica un evento nel vostro conto. I webhook sono particolarmente utili per gli eventi asincroni, come la conferma di un pagamento da parte della banca del cliente, la contestazione di un addebito da parte del cliente o la riscossione di pagamenti in abbonamento. \u00c8 possibile configurare gli endpoint dei webhook tramite l'API per ricevere la notifica degli eventi.","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\/ko\/docs\/webhooks\/","og_locale":"it_IT","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\/ko\/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 minuti"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/wooshpay.com\/ko\/docs\/webhooks\/","url":"https:\/\/wooshpay.com\/ko\/docs\/webhooks\/","name":"Webhook - WooshPay","isPartOf":{"@id":"https:\/\/www.wooshpay.com\/zh\/#website"},"primaryImageOfPage":{"@id":"https:\/\/wooshpay.com\/ko\/docs\/webhooks\/#primaryimage"},"image":{"@id":"https:\/\/wooshpay.com\/ko\/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 utilizza i webhook per notificare alla vostra applicazione quando si verifica un evento nel vostro conto. I webhook sono particolarmente utili per gli eventi asincroni, come la conferma di un pagamento da parte della banca del cliente, la contestazione di un addebito da parte del cliente o la riscossione di pagamenti in abbonamento. \u00c8 possibile configurare gli endpoint dei webhook tramite l'API per ricevere la notifica degli eventi.","breadcrumb":{"@id":"https:\/\/wooshpay.com\/ko\/docs\/webhooks\/#breadcrumb"},"inLanguage":"it-IT","potentialAction":[{"@type":"ReadAction","target":["https:\/\/wooshpay.com\/ko\/docs\/webhooks\/"]}]},{"@type":"ImageObject","inLanguage":"it-IT","@id":"https:\/\/wooshpay.com\/ko\/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\/ko\/docs\/webhooks\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.wooshpay.com\/zh\/"},{"@type":"ListItem","position":2,"name":"Docs","item":"https:\/\/wooshpay.com\/fr\/docs\/"},{"@type":"ListItem","position":3,"name":"Webhook"}]},{"@type":"WebSite","@id":"https:\/\/www.wooshpay.com\/zh\/#website","url":"https:\/\/www.wooshpay.com\/zh\/","name":"WooshPay","description":"Piattaforma di pagamento unica","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.wooshpay.com\/zh\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"it-IT"}]}},"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:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/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…","_links":{"self":[{"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/wp-json\/wp\/v2\/docs\/11960","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/wp-json\/wp\/v2\/comments?post=11960"}],"version-history":[{"count":0,"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/wp-json\/wp\/v2\/docs\/11960\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/wp-json\/wp\/v2\/media\/17289"}],"wp:attachment":[{"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/wp-json\/wp\/v2\/media?parent=11960"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/wp-json\/wp\/v2\/doc_category?post=11960"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/it\/wp-json\/wp\/v2\/doc_tag?post=11960"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}