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.
In your Worldpay browser tab, select Profile in the left-hand menu. If you are prompted to choose a merchant code, select the appropriate one.
In your GOV.UK Pay browser tab, go to My services to select the live service you want to set up. Select Settings, then Account credentials, then Edit credentials.
In Worldpay, copy the Worldpay Merchant Code from Identification into the GOV.UK Pay Merchant code field.
Copy the Worldpay New 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
If you’re setting up another GOV.UK Pay service using the same Worldpay merchant code, you should not need to change your XML password again. If you do change it in this situation, you will need to update your other services with the new XML password.
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 0ff (not
Set up “Merchant Channel”
In the left-hand menu of your Worldpay account, select Merchant Channel.
You must edit the content in the http row, under Protocol.
For Merchant Channels (Production) and Merchant Channels (Test), check the following:
- Under Active, select yes.
- Set Content to xml
- 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 Merchant Channel Events (Production) and Merchant Channel Events (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. Make sure you use a live API key, not a test one. 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.
If you are testing your integration with a payment link, you should open it in a separate browser tab to avoid confusion.
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 My services to select the live service you want to set up. Select Settings, then 3D Secure and then select Turn 3D Secure on.