Merge pull request #1039 from alphagov/PP-14695-Update-Test-Pay-Integration-Content-For-Testing-Modes

Update Test your integration page for testing modes

Author: fmcgrath

source/integrate_with_govuk_pay/index.html.md.erb

@@ -1,6 +1,6 @@
 ---
 title: Integrate with the GOV.UK Pay API
-last_reviewed_on: 2025-11-13
+last_reviewed_on: 2026-03-02
 review_in: 6 months
 weight: 2050
 ---
@@ -78,20 +78,13 @@ The following example UML sequence diagram shows a typical happy-path payment jo
 
 ## Identifying your user when they return to your service
 
-We recommend using a cookie-based session to identify your user when they
-return to your service. You could use either encrypted client side sessions,
-or server-side sessions using session store.
+We recommend using a cookie-based session to identify users when they return to your service. You can use encrypted client-side sessions or server-side sessions with a session store.
 
-We recommend that you do not encode any reference number or user-
-specific information  in the `return_url`. For example, do not use
-`/payment_12345` at the end of your `return_url`.
+Do not put any reference numbers or user-specific information in the `return_url`. For example, do not add `/payment_12345` at the end of your `return_url`.
 
-If you do, an attacker may be able to guess the reference in your
-`return_url` and gain access to another user's personal information displayed
-on your confirmation screen.
+If you do, an attacker may be able to guess the reference in your `return_url` and see another user’s personal information on the confirmation page.
 
-You must [use HTTPS for your `return_url`](/security/#https), but you can use
-HTTP when your service is in sandbox or 'not live yet' mode.
+You must [use HTTPS for your `return_url`](/security/#https). You can use HTTP only when your service is in sandbox or ‘not live yet’ mode.
 
 ## Make sure that all payments are processed
 

source/moto_payments/index.html.md.erb

@@ -1,6 +1,6 @@
 ---
 title: Take payments over the phone or by post ('MOTO')
-last_reviewed_on: 2025-11-13
+last_reviewed_on: 2026-03-02
 review_in: 6 months
 weight: 2400
 ---
@@ -50,16 +50,18 @@ Email [govuk-pay-support@digital.cabinet-office.gov.uk](mailto:govuk-pay-support
 * both your organisation and any suppliers or delivery partners hold a valid AOC
 * you would like to take MOTO payments on your live service
 
-We’ll email you to let you know when we’ve turned on MOTO payments.
+We will email you when we have enabled MOTO payments.
 
 #### Worldpay - turn on MOTO payments on a live account
 
-1. Create a new MOTO service that is separate from your online payments service - to do this, sign in to the [GOV.UK Pay admin tool](https://selfservice.payments.service.gov.uk) and select **Add a new service**.
+1. Create a new MOTO service that is separate from your online payments service. To do this, sign in to the [GOV.UK Pay admin tool](https://selfservice.payments.service.gov.uk) and select **Add a new service**.
 
-1. You need to process MOTO payments on a separate MOTO merchant code to the one you use for online (non-MOTO) payments. If you do not already have a merchant code for MOTO payments, ask for one by contacting Government Banking. You’ll use this merchant code when you [connect your new service to your PSP](https://docs.payments.service.gov.uk/switching_to_live/#go-live).
+1. Get a MOTO merchant code for MOTO payments. Contact Government Banking if you need one. MOTO payments and online payments are processed with separate merchant codes. 
 
-1. Email [govuk-pay-support@digital.cabinet-office.gov.uk](mailto:govuk-pay-support@digital.cabinet-office.gov.uk) to confirm you and any suppliers or delivery partners comply with the latest version of PCI DSS. In the same email, let us know that would like to take MOTO payments on your account. 
+1. Use this MOTO merchant code when you [connect your new service to your PSP](/switching_to_live/#go-live).
 
-We’ll email you to let you know we’ve turned on MOTO payments.
+1. Email [govuk-pay-support@digital.cabinet-office.gov.uk](mailto:govuk-pay-support@digital.cabinet-office.gov.uk) to confirm PCI DSS compliance for you and any suppliers or delivery partners. In the same email, ask us to enable MOTO payments on your account.
+
+We will email you when we have enabled MOTO payments.
 
 You can still [take online payments](https://docs.payments.service.gov.uk/making_payments/) through your non-MOTO service.

source/quick_start_guide/index.html.md.erb

@@ -1,6 +1,6 @@
 ---
 title: Quick start
-last_reviewed_on: 2025-11-13
+last_reviewed_on: 2026-03-02
 review_in: 6 months
 weight: 1200
 ---
@@ -15,8 +15,7 @@ Read this section to learn about what to do to get started with GOV.UK Pay.
 
 Before you start using GOV.UK Pay, you should:
 
-* read how to [get started](https://www.payments.service.gov.uk/getstarted/) and decide if GOV.UK
-Pay is right for your service
+* read how to [get started](https://www.payments.service.gov.uk/getstarted/) and decide if GOV.UK Pay is right for your service
 * sign up to the [GOV.UK Pay admin tool](https://selfservice.payments.service.gov.uk/register/email-address)
 * create a service in the GOV.UK Pay admin tool
 * read the GOV.UK Service Manual guidance on [deploying new
@@ -47,24 +46,24 @@ To set up a payment link, [create an account](https://selfservice.payments.servi
 
 ## The GOV.UK Pay API
 
-The GOV.UK Pay API is based on REST principles with endpoints returning data
-in JSON format, and standard HTTP error response codes. Our API
-lets you:
+You can use the GOV.UK Pay API to:
 
 * begin and complete payments
 * view the event history for individual payments
 * view transactions, refunds, and disputes within a specified time period
 * issue full or partial refunds
 * create agreements to take recurring payments
 
-You can create 2 types of API keys for your GOV.UK Pay service. These are:
+The API follows REST principles. Endpoints return JSON data and use standard HTTP status codes for errors. 
 
-- test API keys, for [testing your service before it goes live and for testing in sandbox mode](/testing_govuk_pay)
-- live API keys, for taking payments from your users after you [go live](/switching_to_live)
+You can create 2 types of API keys for your GOV.UK Pay service. You can create:
 
-If your payment service provider (PSP) is Stripe, you can test how [transaction fees](/reporting/#psp-fees) and payments to your bank account work.
+* test API keys for a service that is [‘not live yet’](/testing_govuk_pay)
+* live API keys after [go live](/switching_to_live)
 
-When you've signed up for GOV.UK Pay and created a service, follow these instructions to get started with our API and make a test API request.
+When you’ve signed up for GOV.UK Pay and created a service, create a test API key and make a test payment request.
+
+You can still use test API keys for a service after it goes live.
 
 ## Test the API
 
@@ -117,17 +116,15 @@ Read more about [taking payments](/making_payments/#take-a-payment).
 
 ### Simulate your users' payment journey
 
-Go to the ``next_url`` with a browser, and you’ll see the payment screen. Choose a [mock card number](/testing_govuk_pay/#mock-card-numbers) and enter it to simulate a payment. For the other required details, enter some test information which should have:
+Go to the `next_url` with a browser, and you’ll see the payment page. Choose a [mock card number](/testing_govuk_pay/#use-mock-card-numbers) and enter it to simulate a payment. For the other required details, enter some test information, which should have:
 
   * an expiry date that is in the future and in the format MM/YYYY or MM/YY
-
   * a valid postcode
 
 Submit the payment.
 
 ### View transactions at GOV.UK Pay admin tool
 
-Select an account in the [GOV.UK Pay admin
-tool](https://selfservice.payments.service.gov.uk/), then select __Transactions__.
+Select an account in the [GOV.UK Pay admin tool](https://selfservice.payments.service.gov.uk/), then select **Transactions**.
 
 You can also view test transactions using the API.

source/recurring_payments/index.html.md.erb

@@ -1,6 +1,6 @@
 ---
 title: Take recurring payments
-last_reviewed_on: 2025-11-13
+last_reviewed_on: 2026-03-03
 review_in: 6 months
 weight: 2200
 ---
@@ -322,7 +322,7 @@ You can [read more about using webhooks to automatically receive updates](/webho
 
 ### Test your recurring payments integration
 
-GOV.UK Pay have [mock card numbers for you to test your integration](/testing_govuk_pay/#mock-card-numbers), including a [mock card number for testing recurring payments](/testing_govuk_pay/#testing-recurring-payments-on-a-test-account). You can use this mock card number to set up an agreement with an initial payment, but further recurring payments will be declined.
+GOV.UK Pay have [mock card numbers for you to test your integration](/testing_govuk_pay/#use-mock-card-numbers). You can also use specific mock card numbers to test recurring payments.
 
 
 ##Contacting your users

source/switch_payment_service_provider/switch_psp_to_stripe/index.html.md.erb

@@ -69,7 +69,7 @@ You need to repeat the following process for each service you want to switch.
 1. Select **Settings**.
 1. Under **Payment provider**, select **Switch to Stripe**.
 
-Complete the tasks on this screen to start switching to Stripe.
+Complete the tasks on this page to start switching to Stripe.
 
 
 ### 2b. Make a test payment to complete the switch to Stripe