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

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

WooshPay utiliza webhooks para notificar a su aplicaci\u00f3n cuando se produce un evento en su cuenta. Los webhooks son especialmente \u00fatiles para eventos as\u00edncronos, como cuando el banco de un cliente confirma un pago, un cliente impugna un cargo o cuando se cobran pagos de suscripciones. Puede configurar puntos finales de webhook a trav\u00e9s de la API para recibir notificaciones sobre eventos.<\/p>\n\n\n\n

Pasos para crear y recibir Webhooks<\/h2>\n\n\n\n

Puede empezar a recibir notificaciones de eventos en su aplicaci\u00f3n siguiendo los pasos de esta secci\u00f3n:<\/p>\n\n\n\n

    \n
  1. Identifique los eventos que desea supervisar y los eventos<\/a> para analizar.<\/li>\n\n\n\n
  2. Cree un punto final webhook como un punto final HTTP (URL) en su servidor local.<\/li>\n\n\n\n
  3. Gestiona las solicitudes de WooshPay analizando cada objeto de evento y devolviendo 2xx<\/code><\/strong> c\u00f3digos de estado de respuesta.<\/li>\n\n\n\n
  4. Despliega tu punto final de webhook para que sea una URL HTTPS de acceso p\u00fablico.<\/li>\n\n\n\n
  5. Registre su URL HTTPS de acceso p\u00fablico mediante el objeto webhook.<\/li>\n<\/ol>\n\n\n\n

    C\u00f3mo crear un punto final webhook<\/h3>\n\n\n\n

    Crear un endpoint webhook no es diferente de crear cualquier otra p\u00e1gina en tu sitio web. Es un endpoint HTTP o HTTPS en tu servidor con una URL. Si todav\u00eda est\u00e1s desarrollando tu endpoint en tu m\u00e1quina local, puede ser HTTP. Despu\u00e9s de que sea accesible al p\u00fablico, debe ser HTTPS.<\/p>\n\n\n\n

    Paso 1. Identificar los eventos que deben controlarse<\/h3>\n\n\n\n

    Utilice la gu\u00eda de referencia de la API para identificar los eventos de Wooshpay y sus objetos de evento que su punto final de webhook necesita analizar.<\/p>\n\n\n\n

    Segundo paso: Crear un webhook<\/a><\/h3>\n\n\n\n

    Configure un punto final HTTP en su equipo local que pueda aceptar solicitudes de webhook no autenticadas con un m\u00e9todo POST.<\/p>\n\n\n\n

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

    {\n    \"url\": \"https:\/\/apitest.wooshpay.com\/v1\/receives\",\n    \"descripci\u00f3n\": \"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        \"cargo.reembolso.actualizado\"\n    ],\n    \"api_version\": \"1.0.1\"\n}<\/code><\/pre>\n\n\n\n
    Respuesta<\/em><\/strong><\/p>\n\n\n\n
    {\n    \"id\": \"we_1600745739909070848\",\n    \"object\": \"webhook_endpoint\",\n    \"creado\": 1670482499000,\n    \"descripci\u00f3n\": \"soy descripci\u00f3n\",\n    \"metadata\": null,\n    \"secreto\": \"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        \"cargo.reembolso.actualizado\"\n    ]\n}<\/code><\/pre>\n\n\n\n
    Paso 3: Gestionar las solicitudes de WooshPay<\/h3>\n\n\n\n
    Tu endpoint debe estar configurado para leer objetos de eventos para el tipo de notificaciones de eventos que quieras recibir. WooshPay env\u00eda eventos a su punto final webhook como parte de una solicitud POST con una carga JSON.<\/p>\n\n\n\n
    Devolver una respuesta 2xx<\/strong>
    Su endpoint debe devolver r\u00e1pidamente un c\u00f3digo de estado correcto (2xx) antes de cualquier l\u00f3gica compleja que pudiera causar un timeout.<\/p>\n\n\n\n
    Intentos y reintentos de entrega<\/h2>\n\n\n\n
    Entender c\u00f3mo ver los intentos de entrega, registros de eventos, y la l\u00f3gica de reintento cuando los eventos webhook no son reconocidos.<\/p>\n\n\n\n
    L\u00f3gica de reintento<\/strong>
    En modo directo y de prueba, WooshPay intenta entregar sus webhooks durante un m\u00e1ximo de tres d\u00edas con un back off exponencial, lo que significa que en total entregaremos 18 veces en 72 horas.<\/p>\n\n\n\n
    L\u00f3gica Webhook pendiente<\/strong>
    En los modos en vivo y de prueba, WooshPay intentar\u00e1 notificarte por correo electr\u00f3nico cualquier webhooks fallido si un endpoint no ha respondido con un c\u00f3digo de estado HTTP 2xx. El correo electr\u00f3nico no s\u00f3lo le indicar\u00e1 la URL que no se ha podido entregar, sino tambi\u00e9n cu\u00e1ndo dejaremos de entregar los webhooks, as\u00ed como la mejor forma de ponerse en contacto con nosotros.<\/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\/es\/author\/zhaozixu\/"},"doc_category_info":[{"term_name":"After the payments","term_url":"https:\/\/wooshpay.com\/es\/docs-category\/after-the-payments\/"}],"doc_tag_info":[{"term_name":"open api","term_url":"https:\/\/wooshpay.com\/es\/docs-tag\/open-api\/"},{"term_name":"payment","term_url":"https:\/\/wooshpay.com\/es\/docs-tag\/payment\/"},{"term_name":"Payment Flow","term_url":"https:\/\/wooshpay.com\/es\/docs-tag\/payment-flow\/"},{"term_name":"webhhoks","term_url":"https:\/\/wooshpay.com\/es\/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\/es\/docs\/webhooks\/\" \/>\n<meta property=\"og:locale\" content=\"es_ES\" \/>\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\/es\/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\":\"es\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/wooshpay.com\/ko\/docs\/webhooks\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"es\",\"@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\":\"es\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Gancho web - WooshPay","description":"WooshPay utiliza webhooks para notificar a su aplicaci\u00f3n cuando se produce un evento en su cuenta. Los webhooks son especialmente \u00fatiles para eventos as\u00edncronos, como cuando el banco de un cliente confirma un pago, un cliente impugna un cargo o cuando se cobran pagos de suscripciones. Puede configurar puntos finales de webhook a trav\u00e9s de la API para recibir notificaciones 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\/es\/docs\/webhooks\/","og_locale":"es_ES","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\/es\/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":"Gancho web - 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 utiliza webhooks para notificar a su aplicaci\u00f3n cuando se produce un evento en su cuenta. Los webhooks son especialmente \u00fatiles para eventos as\u00edncronos, como cuando el banco de un cliente confirma un pago, un cliente impugna un cargo o cuando se cobran pagos de suscripciones. Puede configurar puntos finales de webhook a trav\u00e9s de la API para recibir notificaciones sobre eventos.","breadcrumb":{"@id":"https:\/\/wooshpay.com\/ko\/docs\/webhooks\/#breadcrumb"},"inLanguage":"es","potentialAction":[{"@type":"ReadAction","target":["https:\/\/wooshpay.com\/ko\/docs\/webhooks\/"]}]},{"@type":"ImageObject","inLanguage":"es","@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 pago \u00fanica","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":"es"}]}},"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\/es\/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:\/\/wooshpay.com\/es\/wp-json\/wp\/v2\/docs\/11960","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wooshpay.com\/es\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/wooshpay.com\/es\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/wooshpay.com\/es\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/wooshpay.com\/es\/wp-json\/wp\/v2\/comments?post=11960"}],"version-history":[{"count":0,"href":"https:\/\/wooshpay.com\/es\/wp-json\/wp\/v2\/docs\/11960\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wooshpay.com\/es\/wp-json\/wp\/v2\/media\/17289"}],"wp:attachment":[{"href":"https:\/\/wooshpay.com\/es\/wp-json\/wp\/v2\/media?parent=11960"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/wooshpay.com\/es\/wp-json\/wp\/v2\/doc_category?post=11960"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/wooshpay.com\/es\/wp-json\/wp\/v2\/doc_tag?post=11960"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}