{"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\/pt\/docs\/webhooks\/","title":{"rendered":"Webhook"},"content":{"rendered":"

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

O WooshPay usa webhooks para notificar seu aplicativo quando ocorre um evento em sua conta. Os webhooks s\u00e3o particularmente \u00fateis para eventos ass\u00edncronos, como quando o banco de um cliente confirma um pagamento, quando um cliente contesta uma cobran\u00e7a ou quando cobra pagamentos de assinatura. Voc\u00ea pode configurar pontos de extremidade de webhook por meio da API para ser notificado sobre eventos.<\/p>\n\n\n\n

Etapas para criar e receber webhooks<\/h2>\n\n\n\n

Voc\u00ea pode come\u00e7ar a receber notifica\u00e7\u00f5es de eventos no seu aplicativo usando as etapas desta se\u00e7\u00e3o:<\/p>\n\n\n\n

    \n
  1. Identifique os eventos que voc\u00ea deseja monitorar e os eventos<\/a> cargas \u00fateis a serem analisadas.<\/li>\n\n\n\n
  2. Crie um ponto de extremidade de webhook como um ponto de extremidade HTTP (URL) em seu servidor local.<\/li>\n\n\n\n
  3. Tratar as solicita\u00e7\u00f5es do WooshPay analisando cada objeto de evento e retornando 2xx<\/code><\/strong> c\u00f3digos de status de resposta.<\/li>\n\n\n\n
  4. Implante seu endpoint de webhook para que seja um URL HTTPS acess\u00edvel publicamente.<\/li>\n\n\n\n
  5. Registre seu URL HTTPS acess\u00edvel publicamente por meio de um objeto webhook.<\/li>\n<\/ol>\n\n\n\n

    Como criar um ponto de extremidade de webhook<\/h3>\n\n\n\n

    Criar um ponto de extremidade de webhook n\u00e3o \u00e9 diferente de criar qualquer outra p\u00e1gina em seu site. Trata-se de um endpoint HTTP ou HTTPS em seu servidor com um URL. Se voc\u00ea ainda estiver desenvolvendo seu endpoint em seu computador local, ele poder\u00e1 ser HTTP. Depois que estiver acess\u00edvel ao p\u00fablico, ele dever\u00e1 ser HTTPS.<\/p>\n\n\n\n

    Etapa 1. Identificar os eventos a serem monitorados<\/h3>\n\n\n\n

    Use o guia de refer\u00eancia da API para identificar os eventos do Wooshpay e seus objetos de evento que o ponto de extremidade do webhook precisa analisar.<\/p>\n\n\n\n

    Etapa 2: Criar um webhook<\/a><\/h3>\n\n\n\n

    Configure um ponto de extremidade HTTP em seu computador local que possa aceitar solicita\u00e7\u00f5es de webhook n\u00e3o autenticadas com um m\u00e9todo POST.<\/p>\n\n\n\n

    Solicita\u00e7\u00e3o<\/em><\/strong><\/p>\n\n\n\n

    {\n    \"url\": \"https:\/\/apitest.wooshpay.com\/v1\/receives\",\n    \"description\" (descri\u00e7\u00e3o): \"Eu sou a descri\u00e7\u00e3o\",\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
    Resposta<\/em><\/strong><\/p>\n\n\n\n
    {\n    \"id\": \"we_1600745739909070848\",\n    \"object\": \"webhook_endpoint\",\n    \"created\": 1670482499000,\n    \"description\" (descri\u00e7\u00e3o): \"Eu sou a descri\u00e7\u00e3o\",\n    \"metadata\": nulo,\n    \"secret\": \"c2tfdGVzdF9kR1Z6ZERwMFpYTjBNVEl6TkRVMjo=\",\n    \"status\": \"enabled\" (habilitado),\n    \"url\": \"https:\/\/apitest.wooshpay.com\/v1\/receives\",\n    \"livemode\": falso,\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
    Etapa 3: Tratar as solicita\u00e7\u00f5es do WooshPay<\/h3>\n\n\n\n
    Seu endpoint deve ser configurado para ler objetos de evento para o tipo de notifica\u00e7\u00e3o de evento que voc\u00ea deseja receber. O WooshPay envia eventos para seu endpoint de webhook como parte de uma solicita\u00e7\u00e3o POST com uma carga \u00fatil JSON.<\/p>\n\n\n\n
    Retornar uma resposta 2xx<\/strong>
    Seu endpoint deve retornar rapidamente um c\u00f3digo de status bem-sucedido (2xx) antes de qualquer l\u00f3gica complexa que possa causar um tempo limite.<\/p>\n\n\n\n
    Tentativas de entrega e novas tentativas<\/h2>\n\n\n\n
    Entenda como visualizar as tentativas de entrega, os registros de eventos e a l\u00f3gica de nova tentativa quando os eventos de webhook n\u00e3o s\u00e3o reconhecidos.<\/p>\n\n\n\n
    L\u00f3gica de repeti\u00e7\u00e3o<\/strong>
    No modo ao vivo e de teste, o WooshPay tenta entregar seus webhooks por at\u00e9 tr\u00eas dias com um retorno exponencial, o que significa que, no total, entregaremos 18 vezes em 72 horas.<\/p>\n\n\n\n
    L\u00f3gica de webhook pendente<\/strong>
    No modo ao vivo e de teste, o WooshPay tentar\u00e1 notific\u00e1-lo por e-mail sobre quaisquer webhooks malsucedidos se um endpoint n\u00e3o tiver respondido com um c\u00f3digo de status HTTP 2xx. O e-mail n\u00e3o apenas informar\u00e1 o URL que n\u00e3o pode ser entregue, mas tamb\u00e9m quando deixaremos de entregar os webhooks e a melhor maneira de entrar em contato conosco.<\/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\/pt\/author\/zhaozixu\/"},"doc_category_info":[{"term_name":"After the payments","term_url":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/pt\/docs-category\/after-the-payments\/"}],"doc_tag_info":[{"term_name":"open api","term_url":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/pt\/docs-tag\/open-api\/"},{"term_name":"payment","term_url":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/pt\/docs-tag\/payment\/"},{"term_name":"Payment Flow","term_url":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/pt\/docs-tag\/payment-flow\/"},{"term_name":"webhhoks","term_url":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/pt\/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=\"pt_BR\" \/>\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 minutos\" \/>\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\":\"pt-BR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/wooshpay.com\/ko\/docs\/webhooks\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"pt-BR\",\"@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\":\"pt-BR\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Webhook - WooshPay","description":"O WooshPay usa webhooks para notificar seu aplicativo quando ocorre um evento em sua conta. Os webhooks s\u00e3o particularmente \u00fateis para eventos ass\u00edncronos, como quando o banco de um cliente confirma um pagamento, quando um cliente contesta uma cobran\u00e7a ou quando cobra pagamentos de assinatura. Voc\u00ea pode configurar pontos de extremidade de webhook por meio da API para ser notificado sobre eventos.","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":"pt_BR","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 minutos"},"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":"O WooshPay usa webhooks para notificar seu aplicativo quando ocorre um evento em sua conta. Os webhooks s\u00e3o particularmente \u00fateis para eventos ass\u00edncronos, como quando o banco de um cliente confirma um pagamento, quando um cliente contesta uma cobran\u00e7a ou quando cobra pagamentos de assinatura. Voc\u00ea pode configurar pontos de extremidade de webhook por meio da API para ser notificado sobre eventos.","breadcrumb":{"@id":"https:\/\/wooshpay.com\/ko\/docs\/webhooks\/#breadcrumb"},"inLanguage":"pt-BR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/wooshpay.com\/ko\/docs\/webhooks\/"]}]},{"@type":"ImageObject","inLanguage":"pt-BR","@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":"Plataforma de pagamento em um s\u00f3 lugar","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":"pt-BR"}]}},"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\/pt\/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\/pt\/wp-json\/wp\/v2\/docs\/11960","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/pt\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/pt\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/pt\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/pt\/wp-json\/wp\/v2\/comments?post=11960"}],"version-history":[{"count":0,"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/pt\/wp-json\/wp\/v2\/docs\/11960\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/pt\/wp-json\/wp\/v2\/media\/17289"}],"wp:attachment":[{"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/pt\/wp-json\/wp\/v2\/media?parent=11960"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/pt\/wp-json\/wp\/v2\/doc_category?post=11960"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/d2jcf4noflr1cd.cloudfront.net\/pt\/wp-json\/wp\/v2\/doc_tag?post=11960"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}