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

​
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 - Native SDKs for iOS, Android, React Native, and other platforms
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.

​
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.