Skip to main content

Connect your live account to Worldpay

This is part of going live.

Government Banking’s contracted payment service provider (PSP) is currently Worldpay. You must be a central government or health sector organisation to use Government Banking’s contracted PSP.

You must be an admin on your GOV.UK Pay account to connect to Worldpay.

1. Check your Worldpay account

Make sure your Worldpay account is both:

  • an admin account
  • using the Worldpay Corporate Gateway, not the Worldpay Business Gateway

2. Switch to Production Mode for your merchant code

Sign in to your Worldpay account and select your merchant code.

If Test Mode is at the bottom of the left-hand menu, switch to Production Mode. Worldpay uses the term ‘production’ for live accounts.

3. Connect your Worldpay account to GOV.UK Pay

How you connect your Worldpay account to your GOV.UK Pay service depends on the type of payment you are going to take. There are different processes for:

3a. Connect your one-off or MOTO payments service to your Worldpay account

  1. Select your live account from the Overview page in the GOV.UK Pay admin tool.

  2. Go to the Settings page and select Your PSP - Worldpay.

  3. In your Worldpay account, select Account and the Profile tab, then your merchant code if you’re asked for one.

  4. In your Worldpay account, copy the Merchant Code value from the Identification section. Paste this value into the Merchant code field in your GOV.UK Pay account.

  5. In your Worldpay account, copy the New Username value. Paste this value into the Username field in your GOV.UK Pay account.

  6. In your Worldpay account, if you see a checkbox labelled Disable Original XML Username, select the checkbox and then select Save Profile at the bottom.

  7. In your Worldpay account, if you have not set your XML password for this merchant code before, set it by selecting the pencil icon next to XML Password and choosing a password.

    If you’ve set your XML password before but you cannot remember it, you can set a new password. But you must add the new password to your other services that use this Worldpay account, or they’ll stop working.

    You should follow the guidance about choosing and storing passwords from the National Cyber Security Centre (NCSC).

  8. Confirm your password by selecting Add new password, then OK.

  9. Save the password by selecting the pencil icon again, then Complete, then OK.

  10. In your Worldpay account, copy your XML password. Paste this password into the Password field in your GOV.UK Pay account.

  11. Go to the Payment service section of your Worldpay account.

  12. Set Capture delay (days) to Off (not 0).

    If you do not do this, you may take money from your users before they’ve confirmed their payment.

  13. Contact Worldpay if you want to take payments higher than the amount in Maximum Transaction Amount.

  14. In your GOV.UK Pay account, select Save credentials.

Continue to step 4 to turn on 3DS Flex.

3b. Connect your recurring payments service to your Worldpay account

  1. Select your live account from the Overview page in the GOV.UK Pay admin tool.

  2. Go to the Settings page and select Your PSP - Worldpay.

  3. Select Change in the Recurring customer initiated transaction (CIT) credentials table.

  4. In your Worldpay account, select your customer initiated transaction (CIT) merchant code. Your CIT merchant code ends in ECOMGBP.

    If you’re unsure which merchant code is your CIT, contact either Government Banking or your Worldpay account manager.

  5. In your Worldpay account, select Account and the Profile tab.

  6. In your Worldpay account, copy the Merchant Code value from the Identification section. Paste this value into the CIT merchant code field in the GOV.UK Pay admin tool.

  7. In your Worldpay account, copy the New Username value. Paste this value into the Username field in the GOV.UK Pay admin tool.

  8. In your Worldpay account, if you have not set your XML password for this merchant code before, set it by selecting the pencil icon next to XML Password and choosing a password.

    If you’ve set your XML password before but you cannot remember it, you can set a new password. But you must add the new password to your other services that use this Worldpay account, or they’ll stop working.

    You should follow the guidance about choosing and storing passwords from the National Cyber Security Centre (NCSC).

  9. Confirm your password by selecting Add new password, then OK.

  10. Save the password by selecting the pencil icon again, then Complete, then OK.

  11. In your Worldpay account, copy your XML password. Paste this password into the Password field in your GOV.UK Pay account.

  12. Go to the Payment service section of your Worldpay account.

  13. Set Capture delay (days) to Off (not 0).

    If you do not do this, you may take money from your users before they’ve confirmed their payment.

  14. Contact Worldpay if you want to take payments higher than the amount in Maximum Transaction Amount.

  15. In the GOV.UK Pay admin tool, select Save credentials.

  16. Select Change in the Recurring merchant initiated transaction (MIT) credentials table.

  17. In your Worldpay account, select your merchant initiated transaction (MIT) merchant code from the navigation panel on the left. Your MIT merchant code ends in RECGBP.

    If you’re unsure which merchant code is your MIT, contact either Government Banking or your Worldpay account manager.

  18. Repeat steps 6 to 15 to link your MIT merchant code to your recurring payment service.

Continue to step 4 to turn on 3DS Flex.

4. Turn on 3DS2 (3DS Flex)

3DS Flex is a Worldpay product that turns on 3DS2 payment authentication. You must turn on 3DS Flex to take payments using GOV.UK Pay.

If you are setting up a MOTO service, you do not need to turn on 3DS Flex.

As part of your onboarding, Worldpay should have sent you your 3DS Flex credentials. You can also find your 3DS credentials in Worldpay’s Merchant Admin Interface by selecting INTEGRATION and then 3DS Flex.

  1. In the GOV.UK Pay admin tool, select the account you want to set up on the Overview page.

  2. Select Settings, then Payment channels.

  3. Select Add Worldpay 3DS Flex credentials, then enter your 3DS Flex credentials in the Organisational unit ID, Issuer (API ID), and JWT MAC key (API key) fields.

  4. Select Save and continue.

Set up your Worldpay ‘Merchant Channels’

You must set up your Worldpay ‘Merchant Channels’ so Worldpay can notify GOV.UK Pay about payment events.

If you’re setting up a recurring payments service, you must make these changes for both your customer initiated transaction and your merchant initiated transaction merchant codes.

In your Worldpay account, select Integration then the Merchant Channel tab.

Set up ‘Merchant Channels’

You must make the following changes in both the Merchant Channels (Production) and Merchant Channels (Test) sections.

Set Active to:

  • no in the email row
  • yes in the http row
  • no in the shopper email row

In the http row, set:

  • Content to xml
  • Address to https://notifications.payments.service.gov.uk/v1/api/notifications/worldpay
  • Method to POST
  • Client certificate to no

5. Set up ‘Merchant Channel Events’

In both the Merchant Channel Events (Production) and Merchant Channel Events (Test) sections, select the following in the http row.

  • SHOPPER_REDIRECTED
  • SENT_FOR_AUTHORISATION
  • AUTHORISED
  • ERROR
  • CANCELLED
  • CAPTURED
  • CAPTURE_FAILED
  • SETTLED
  • SETTLED_BY_MERCHANT
  • SENT_FOR_REFUND
  • REFUNDED
  • REFUNDED_BY_MERCHANT
  • REFUSED
  • REFUSED_BY_BANK (production only)
  • REFUND_FAILED

Once you’ve set up your Worldpay ‘Merchant Channels’, your live account is connected to Worldpay. Continue with the next steps to going live.