Skip to main content
Who should use this guideThis guide is intended for merchants who:
  • Use Payrails as a payment orchestrator
  • Use Worldpay (Access Worldpay) for card, wallet or local payment method processing
  • Have an active Worldpay account with API credentials and an entity

​
Create a Worldpay integration in Payrails

  1. Log in to the Payrails portal.
  2. Go to Settings → Integrations.
  3. Select Add instance to create a new integration configuration.
  4. Select the workspaces where this integration should be available.
About workspacesWorkspaces determine where this integration is available. They let you isolate provider setups by region or business line, or share the same configuration across multiple workspaces.

​
Step 1: Choose the integration type

  • Select Payment.
  • Continue to the next step.

​
Step 2: Choose the provider

  • Select Worldpay.
  • Continue to the next step.
A screenshot showing Worldpay selected as the provider.

​
Step 3: Configure your Worldpay integration

What you’ll need from WorldpayBefore you begin, make sure you have your Worldpay API username and password, your entity, and access to the Worldpay dashboard to set up webhooks.

​
Integration instance name

An integration instance is a specific payment provider setup in Payrails. You can create multiple instances for different regions, currencies, or business needs. Choose a clear, consistent name, as it is used in routing.
In Payrails
  • Enter an Instance name for your integration, for example merchant_worldpay.
A screenshot showing the integration instance name field.

​
Account details

In Payrails A screenshot showing the Worldpay account details fields.

​
Payment methods

In Payrails A screenshot showing the Worldpay payment method selection.

​
Credentials

In Payrails Payrails sends requests to Worldpay’s test environment in test mode and to Worldpay’s live environment in live mode, so use the credentials for the matching environment. A screenshot showing the Worldpay credential fields.

​
Webhooks or notifications

Payrails uses provider webhooks or notifications to receive asynchronous payment status updates.
Create webhooks in the same mode (test or live) as your Payrails integration.
In Payrails
  • Copy the Notification URL shown under Account configuration at the top of the integration form.
In Worldpay
  1. In the Worldpay dashboard, create a webhook with the Payrails notification URL.
  2. Subscribe it to the payment events: sent for authorization, authorized, refused, sent for settlement, settlement failed, sent for refund, refund failed, cancelled, expired, error and token created.
  3. Set the webhook to sign events with an HMAC secret key, and enter the same key in HMAC Secret Key in Payrails.

​
Request fields for Worldpay

Send these fields in the authorize request for card payments, in addition to the standard authorize fields. Required fields must be present for the payment to succeed. Payrails sends Optional fields to Worldpay when you include them. For more about meta fields, refer to Meta fields.

​
Configure Worldpay settings

Some Worldpay integration settings change how Payrails processes your payments. The portal shows the same description when you hover over each setting.

​
Support Account Funding Transactions (AFTs)

Turn on Support Account Funding Transactions (AFTs) to send account funding data with your authorizations. Payrails adds the recipient and sender details from meta.order, the customer and the billing address to the Worldpay request. Turn on Support Mastercard Transaction Link Identifier (TLID) only after Worldpay switches TLID on for your entity; ask your Worldpay relationship manager. Payrails then quotes the stored transaction link ID with the network transaction reference on merchant-initiated Mastercard payments. With the setting off, merchant-initiated payments quote the network transaction reference alone.

​
Acquirer details for 3D Secure

If you run 3D Secure through Payrails rather than through Worldpay, fill in the acquirer BIN and acquirer merchant ID for each card scheme you process: Acquirer Bin Visa, Acquirer Merchant ID Visa and the matching Mastercard and Amex fields. Your acquirer assigns these values. Payrails sends them with each 3D Secure authentication for that card scheme.

​
Enable the integration

In Payrails
  • Select Save account to enable the integration.
  • Confirm the integration shows as Enabled.
Your Worldpay integration is now ready to process payments.

​
Next steps

  1. Run a test payment using a Worldpay test card.
  2. Verify that:
    • The payment appears in Worldpay.
    • The payment status updates correctly in Payrails.
  3. Once verified in test mode, repeat the setup in live mode.
→ Continue to: Test a payment
Last modified on October 6, 2026