Set up a live Worldpay account
Please read the guidance on what to do before you switch to live first.
Worldpay uses the term ‘production’ for live accounts.
You should follow these instructions in order.
Before you begin, make sure you have an admin account with both Worldpay and GOV.UK Pay.
Set up your merchant code
Sign in to your Worldpay account and use Select MerchantCode to find your merchant code.
If Switch to Production is at the bottom of the left-hand menu, toggle it on.
Set up your profile
To set up your profile, you need to copy credentials from your Worldpay account into your GOV.UK Pay account.
Select Profile in the left-hand menu in your Worldpay account.
In your GOV.UK Pay browser tab, go to Switch service to select the live service you want to set up. Select Settings, then Account credentials, then Edit credentials.
In your Worldpay browser tab, go to the Profile page, then select Identification.
Copy the Worldpay Merchant Code into the GOV.UK Pay Merchant ID field.
Copy the Worldpay Original XML Username into the GOV.UK Pay Username field.
Change the Worldpay XML password:
select the pencil icon next to XML Password
change the password and select Add new Password
select OK to go back to the Profile page
select the pencil icon again, then Complete then OK
Copy the Worldpay XML password into the GOV.UK Pay Password field.
In your GOV.UK Pay browser tab, select Save credentials to go back to the Account credentials page.
In your Worldpay browser tab, go to the Profile page. Go to the Payment service section and set Capture delay (days) to Off.
Set up “Merchant Channel”
In the left-hand menu of your Worldpay account, select Merchant Channel. Go to the http Protocol row of the Merchant Channels (Production) category.
You should see 4 groupings of settings.
For the first 2, Merchant Channels (Production) and Merchant Channels (Test):
- Under Active, select yes.
- Set Address to
- Set Method to POST.
- Set Client certificate to no.
- Under Merchant Channels (Production) and Active, set the email and shopper email protocols to no.
For the next 2, also named Merchant Channels (Production) and Merchant Channels (Test):
Check the following in the http row only:
Test your configuration
- Contact your Worldpay account manager to confirm the cards you want to accept are set up.
- Make a test transaction on your live account. You can use the GOV.UK Pay API to do this, or use payment links if your service is not yet connected to GOV.UK Pay.
- Sign in to your GOV.UK Pay account.
- Go to the Transactions page and check your test transaction is in the list of transactions.
- Select the test transaction and check if you can refund it.
The refund option may take up to 20 minutes to appear after submitting the transaction.
Set up 3D Secure
Ask your Worldpay account manager to configure your merchant code to enable 3D Secure for all payments.
When this is available, sign in to your GOV.UK Pay account. Go to Switch service to select the live service you want to set up. Select Settings, then 3D Secure and then select Turn 3D Secure on.