Skip to main content
All CollectionsPaymentsWorldpay
Integrating with WorldPay
Integrating with WorldPay

How to link Worldpay to your Bookwhen account to take payments

Anni avatar
Written by Anni
Updated over 2 weeks ago

⚠️ Please note: Worldpay is no longer available for new sign-ups. If you're a new customer, please use PayPal or Stripe instead.

This article covers:


Compliance

You need to ensure your Bookwhen account is compliant to accept online payments through WorldPay. There are a couple of steps to take to make your account compliant:

The information you include and accepted card-type logos will then appear in the footer of your public booking page.


Creating the Security Keys

  1. Select Payment Configuration on the sidebar, then Secure Acceptance Settings.

  2. Locate the required Secure Acceptance profile (please note the profile may be inactive, and then toggle within the search feature can be used to locate it)

  3. Select the ellipsis icon [...] under the More column and then select Edit profile

  4. Then select the Security tab, and under Active Keys, select Create key:

    Worldpay screen with arrow pointing at the 'Create key' button

  5. Provide a name for this new key, leave the Signature Verison as '1' and the Signature Method as 'HMAC-SHA256' and select Create:

    Key creation screen showing key name fields and create button


Integrating the Profile ID and Security Keys with Bookwhen

  1. Locate and copy your Merchant ID ending in gbpgbpe, then paste it into the corresponding box in your Bookwhen payment settings:

    Arrow pointing at the merchant ID within worldpay

  2. Locate your 32-digit long Profile ID near the top of the required profile page in the Secure Acceptance Settings:

    • (For example - EE5D0A21-BAE3-42DA-8093-B63F46B4EDAB)

    Worldpay settings with the profile ID highlighted


  3. Copy the Profile ID, and paste it into the Profile ID box in your Bookwhen payment settings.

  4. On the same profile page above, select the Security tab, then View key, where you can copy and paste the Access Key and Secret Key into your Bookwhen account Access Key and Secret Key corresponding boxes.

  5. ⚠️ When adding the Profile ID, Access Key and Secret Key within Bookwhen, ensure that no additional spaces are included.

  6. Lastly, select Save API Keys.

    Worldpay screen with arrows pointing at the key fields


Activating Your Secure Acceptance Profile

A Secure Acceptance profile comprises settings you configure to create a customer checkout experience. Specific settings are needed to ensure that your account can accept payments.

To configure and activate your profile:

  1. Select the Payment Form tab on the required profile page.

  2. Then scroll down to Checkout Steps and ensure that the Billing Information checkbox is Enabled:

    Worldpay checkout steps screen showing enable and disabled buttons

  3. Scroll further down to the Billing Information checkboxes table, and ensure they match this example:

    Billing information table on worldpay showing display, edit and require checkbox lists

  4. Select Save, to save any changes made to the profile.

  5. Scroll to the top of the profile page and select the back arrow:

    Worldpay screen with arrow pointing at the back arrow within the profile

  6. From the Profile Status dropdown, select Inactive and then Search:

    Secure acceptance settings screen showing profile status and search button

  7. Locate the required profile from the Profile list and then select Promote profile to make the profile changes live:

    Secure acceptance settings screen within worldpay with arrow pointing at the 'promote profile' button

  8. Once the profile is activated by Worldpay, the integration will be ready to accept payments.


Refunds

From October 14th, 2022, Worldpay began updating its payment provider, introducing two ways to issue refunds.

  • Refunding via Worldpay post-migration (CyberSource): If you’ve migrated to the new Worldpay provider (CyberSource), refunds for payments made after migration must be issued through your new Enterprise Business Centre dashboard.

  • Refunding via Worldpay pre-migration (WPOP): Payments made before your migration date were processed through the old Worldpay provider (WPOP). Refunds for these payments must be issued through your WPOP account, which was accessible until November 28th, 2022, after which access was revoked.


AMEX Payments

To display Amex as a payment option, you must manually enable it within your Worldpay account. It won't appear automatically on your Bookwhen page. To do this:

  1. Select Settings, then Payments from the left-hand menu on your account.

  2. Select Manage next to Worldpay.

  3. Select Edit under Show American Express?:

    Worldpay integration screen on Bookwhen with an arrow pointing at the 'Edit' button

  4. Select the tick box next to Show American express as an accepted payment method on your public page?:

    Worldpay integration screen with the Show American express as an accepted payment method on your public page?' checkbox highlighted

  5. Select Save to save your changes.

💡 Important note

  • You can only save Worldpay Cybersource online payment fees with a Merchant ID filled in. Without the Merchant ID, you won't have the View payment hyperlink option on the individual booking that allows you to view the booking on WP automatically,

For example:

Booking cost details showing 'Worldpay payment'


Contact information

You can contact Worldpay:


💬 Any questions or feedback? There are two ways to get in touch:

Thank you! 🕺

Did this answer your question?