From 6bf62fb832c9dfad4b02ac9c4a35c2c4dea4e472 Mon Sep 17 00:00:00 2001 From: NathanD-GDS Date: Wed, 18 Dec 2024 16:30:56 +0000 Subject: [PATCH 1/2] PP-13369: adds information about webhooks retries --- source/webhooks/index.html.md.erb | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/webhooks/index.html.md.erb b/source/webhooks/index.html.md.erb index db187db0..f294d6e7 100644 --- a/source/webhooks/index.html.md.erb +++ b/source/webhooks/index.html.md.erb @@ -179,6 +179,8 @@ When your webhook receives a message, it’ll look like this: ### Retry mechanism -If your service does not return a `2xx` successful response quickly after receiving a webhook message, we’ll try to send the message again. After several attempts, we'll stop retrying. +GOV.UK Pay sends each webhook message at least once. If we do not receive a `2xx` successful response from your service quickly after sending a webhook message, we’ll try to send the message again. After several attempts, we'll stop retrying. + +Sometimes, your service will return a successful response but we might not receive it and will try to send the webhook message again. Your integration should be able to handle receiving the same webhook message more than once. You can see the history of payment events and the message delivery status of each event by selecting **Manage webhook** in [the GOV.UK Pay admin tool](https://selfservice.payments.service.gov.uk/). Each line of the **Events history** table is a single event. Select a payment event to see details of that event, including when it was sent, the body of the webhook message, and any previous delivery attempts. From 9ef54975793b0cd17147045af7c128ca209d119c Mon Sep 17 00:00:00 2001 From: NathanD-GDS Date: Wed, 18 Dec 2024 16:52:51 +0000 Subject: [PATCH 2/2] Changes following tech writer 2i --- source/webhooks/index.html.md.erb | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/source/webhooks/index.html.md.erb b/source/webhooks/index.html.md.erb index f294d6e7..f6d8e91e 100644 --- a/source/webhooks/index.html.md.erb +++ b/source/webhooks/index.html.md.erb @@ -179,7 +179,11 @@ When your webhook receives a message, it’ll look like this: ### Retry mechanism -GOV.UK Pay sends each webhook message at least once. If we do not receive a `2xx` successful response from your service quickly after sending a webhook message, we’ll try to send the message again. After several attempts, we'll stop retrying. +GOV.UK Pay sends each webhook message at least once. + +If we receive a `2xx` successful response from your service, we will not try to send the webhook message again. + +If we do not receive a `2xx` successful response from your service quickly after sending a webhook message, we’ll try to send the message again. After several attempts, we'll stop trying. Sometimes, your service will return a successful response but we might not receive it and will try to send the webhook message again. Your integration should be able to handle receiving the same webhook message more than once.