Skip to main content
Worldpay WPG (Worldpay Payment Gateway) is a global payment processing platform offering comprehensive card payment solutions with extensive international coverage. Worldpay WPG provides flexible payment processing capabilities with support for multiple currencies and countries worldwide.

​
Setup

Contact your Worldpay (WPG) account manager to obtain your credentials and set up your account.

​
Connector configuration

After setting up your Worldpay (WPG) account, you can configure the connector in Gr4vy using one of the following methods:
  • Flow - Configure payment routing rules through your Gr4vy dashboard
  • API integration - Specify the payment_service_id when creating transactions to explicitly route payments to this connector

​
Credentials

Configure the following credentials in the Gr4vy dashboard, which are obtained from your Worldpay (WPG) account manager:
  • Username - Your Worldpay (WPG) username for API access
  • Password - Your Worldpay (WPG) password for authentication

​
Capabilities

This connector supports the Mastercard Transaction Link Identifier (TLID). Worldpay must enable the TLID on your merchant code, so ask your Worldpay account manager.

​
Supported countries

​
Supported currencies

​
Integration

To accept card payments with Worldpay (WPG), use one of Gr4vy’s client-side integration methods to securely collect card details. Due to PCI compliance requirements, card data should never be sent directly to your servers. You can integrate using:
  • Embed - A pre-built, customizable payment form that handles the complete payment flow
  • Secure Fields - Embed card input fields for building custom payment forms while maintaining PCI compliance
  • Mobile SDKs - Embed SDKs for iOS, Android, and React Native
These methods handle card data collection and tokenization. Once the card details are collected and tokenized, create a transaction through the Gr4vy API, which routes the payment to your configured Worldpay (WPG) connection based on your Flow rules or explicit payment_service_id parameter.

​
Statement descriptor

Worldpay (WPG) requires a description on every order. Gr4vy builds it from the transaction’s statement_descriptor, joining name and description with a space and sending the first 25 characters. Send statement_descriptor on every transaction to this connection. Without it, Worldpay rejects the order.

​
Authorization validity

According to Worldpay, an authorization has no fixed validity period. The card issuer decides when it expires, typically 5 to 15 days after authorization, so capture as soon as you can. Worldpay’s test environment can’t simulate an expired authorization. Gr4vy doesn’t process Worldpay’s EXPIRED notification, so an expired authorization still shows as authorized in Gr4vy.

​
Payment facilitators

Gr4vy doesn’t send sub-merchant data to Worldpay (WPG), so this connection doesn’t support payment facilitator accounts that require it.

​
Webhook configuration

Webhooks need to be configured in the Worldpay Merchant Administration Interface (MAI) under INTEGRATION → Merchant Channel. For more detailed instructions, refer to the Worldpay setup guide. To ensure Gr4vy stays up to date with the latest payment changes, enable notifications for the following payment statuses:
  • CAPTURED
  • CAPTURE_FAILED
  • REFUSED
  • CANCELLED
  • REFUNDED
  • REFUND_FAILED

​
Idempotency

Your Worldpay (WPG) account manager may need to enable idempotency for your account to support automatic retry handling of duplicate transactions.