Skip to main content
Worldpay is a global payment processor providing card acquiring and alternative payment methods across Europe, the Americas, and Asia-Pacific.

​
Processor Details

Payment MethodsCards Apple Pay Google Pay
Supported CurrenciesMultiple (configured per merchant account)
Metadata Mapping✓
Network Tokens✓ (upon request to Worldpay)
3DS Support✓
3RI Support✓

​
Integration Guide

1

Open Worldpay Merchant Admin Interface

Log in to the Worldpay Merchant Interface (MAI) and ensure your merchant code and API credentials are active.
2

Collect credentials

Obtain the following credentials from Worldpay:
  • Merchant Code
  • API Username
  • API Password
API credentials are separate from Merchant Interface login credentials.
3

Add integration in PayNext

In Dashboard → Integrations, click Add new integration → Worldpay → Connect
4

Enter credentials

  • Name: Label for this connection (e.g., “Worldpay EU”)
  • Merchant Code
  • API Username
  • API Password
  • Network Tokens: Enable if activated by Worldpay
5

Save

Click Connect to complete the integration
6

Add Worldpay Webhook sending

In Worldpay MAI navigate to “Integration” tab on the left, then click Merchant Channel
1
There configure Merchant Channels http protocol:
  • Active: yes
  • Content: xml
  • Address: Check this in PayNext CRM on integrations page
  • Method: POST
2
Then lower in Merchant Channel Events mark following columns in http row:
  • CAPTURED
  • SETTLED
  • SETTLED_BY_MERCHANT
  • VOIDED
  • REFUNDED
  • REFUNDED_BY_MERCHANT

​
Metadata Mapping

Worldpay supports passing merchant-defined metadata in authorization requests. This allows you to control statement descriptors and attach additional context for reconciliation.
Descriptor customization must be enabled on your Worldpay account. Contact Worldpay support if fields are not reflected on statements.
Supported Fields:
Metadata KeyTarget FieldCharacter LimitDescription
descriptionpaymentService.submit.order.description255Order description available in Worldpay MAI
statement_narrativepaymentService.submit.order.statementNarrative50Statement descriptor
Example Usage:
Update Customer Metadata
PATCH /customers/:id
{
  "metadata": {
    "description": "Example"
  }
}