From 5ca2b5c56fe330fc13c4922c7cb03d1a980d4f0c Mon Sep 17 00:00:00 2001 From: Nathan Driver <80888259+NathanD-GDS@users.noreply.github.com> Date: Mon, 18 Mar 2024 08:10:16 +0000 Subject: [PATCH] Apply suggestions from AS review Co-authored-by: asimms41 <102690377+asimms41@users.noreply.github.com> --- source/making_payments/index.html.md.erb | 4 ++-- source/moto_payments/moto_api/index.html.md.erb | 4 ++-- source/recurring_payments/index.html.md.erb | 2 +- source/refunding_payments/index.html.md.erb | 4 ++-- source/webhooks/index.html.md.erb | 2 +- 5 files changed, 8 insertions(+), 8 deletions(-) diff --git a/source/making_payments/index.html.md.erb b/source/making_payments/index.html.md.erb index f0d8fb6e..ccf871a0 100644 --- a/source/making_payments/index.html.md.erb +++ b/source/making_payments/index.html.md.erb @@ -9,7 +9,7 @@ weight: 2100 This section tells you how to take a payment using the GOV.UK Pay API. -If you want to take payments using our no-code solution, you can use [payment links](https://www.payments.service.gov.uk/govuk-payment-pages/). +If you want to take payments using a no-code solution instead, you can use [payment links](https://www.payments.service.gov.uk/govuk-payment-pages/). When your user makes a payment, your service should supply a `reference`. If possible, this should be a unique identifier for the payment. If your @@ -23,7 +23,7 @@ payment journey on GOV.UK Pay ends. ## Creating a payment -The endpoint to create a payment with the GOV.UK Pay API is: +To create a payment with the GOV.UK Pay API, use this endpoint: `POST /v1/payments` diff --git a/source/moto_payments/moto_api/index.html.md.erb b/source/moto_payments/moto_api/index.html.md.erb index 9fc65563..31e2e9ef 100644 --- a/source/moto_payments/moto_api/index.html.md.erb +++ b/source/moto_payments/moto_api/index.html.md.erb @@ -27,8 +27,8 @@ Make sure you've [turned on MOTO (telephone or post) payments on your account](/ } ``` 2. Go to the `next_url` included in the response to your API request. -3. Enter your user’s payment details on the **Enter payment details** page. The **Enter payment details** page will not have a billing address field, even if you've turned on billing address collection on your service. -4. Confirm the payment on the **Confirm your payment** page. You will not need to do 3D Secure confirmation. +3. On the **Enter payment details** page, enter your user’s payment details. The **Enter payment details** page does not have a billing address field, even if you've turned on billing address collection on your service. +4. On the **Confirm your payment** page, confirm the payment details. You will not need to do a 3D Secure confirmation. ### Taking a payment by post diff --git a/source/recurring_payments/index.html.md.erb b/source/recurring_payments/index.html.md.erb index 5bd72015..ba85c56a 100644 --- a/source/recurring_payments/index.html.md.erb +++ b/source/recurring_payments/index.html.md.erb @@ -21,7 +21,7 @@ Your service has [additional responsibilities when taking recurring payments](/r * telling users when you’re going to take or change payments * letting users amend their recurring payments -It would be helpful to be familiar with [the standard GOV.UK Pay payment flow](/payment_flow) before reading about recurring payments. +It would be helpful to familiarise yourself [the standard GOV.UK Pay payment flow](/payment_flow) before reading about recurring payments. This section outlines the recurring payment flow, your responsibilities, and how to set up and use agreements to take recurring payments. diff --git a/source/refunding_payments/index.html.md.erb b/source/refunding_payments/index.html.md.erb index c4ee09fe..55419a5b 100644 --- a/source/refunding_payments/index.html.md.erb +++ b/source/refunding_payments/index.html.md.erb @@ -7,9 +7,9 @@ weight: 4100 # Refund a payment -<%= warning_text('If you are a member of the public trying to get a refund, please contact the department you made the payment to. This page is for civil servants that take payments with GOV.UK Pay. ') %> +<%= warning_text('If you are a member of the public trying to get a refund, please contact the government department you made the payment to. This page is for civil servants that take payments with GOV.UK Pay. ') %> -You can refund all or part of a payment using the GOV.UK Pay API or by signing into the [GOV.UK Pay admin tool](https://selfservice.payments.service.gov.uk/login). This page focuses on refunding through our API. +You can refund all or part of a payment using the GOV.UK Pay API or by signing into the [GOV.UK Pay admin tool](https://selfservice.payments.service.gov.uk/login). This page focuses on refunding payments using our API. Your user will receive the refund in the same account they originally paid from. You cannot refund a payment to another card or bank account. diff --git a/source/webhooks/index.html.md.erb b/source/webhooks/index.html.md.erb index 2abf53ab..db187db0 100644 --- a/source/webhooks/index.html.md.erb +++ b/source/webhooks/index.html.md.erb @@ -7,7 +7,7 @@ weight: 3300 # Receive automatic payment event updates using webhooks -This section tells you how to use webhooks to automatically receive updates after payment events. You'll need a technical team to build webhooks integration. +This section tells you how to use webhooks to automatically receive updates after payment events. You'll need a technical team to build a webhooks integration. A webhook is when GOV.UK Pay sends automatic `POST` requests to your service after payment events. A payment event is when a payment reaches a milestone in its journey and its `state` updates, such as when it’s created, paid, or refunded.