Worldpay (WPG) - Card

Connect to Worldpay WPG to accept card payments

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

Features

Worldpay (WPG) supports the following features:

• Delayed capture - Authorize a payment and capture it at a later time
• Partial capture - Capture a portion of the authorized amount
• Partial refunds - Refund a portion of the captured amount
• Refunds - Refund a captured payment
• Void - Cancel an authorized transaction before capture
• Zero auth - Verify a card without charging it
• Digital wallets - Support for Apple Pay, Google Pay, and other wallet integrations
• Network tokens - Network tokenization is enabled by default
• Transaction sync - Synchronize transaction status with Worldpay (WPG)
• Issuer-based installments - Support for installment payments configured at the issuer level
• 3-D Secure - Pass-through 3DS authentication
• Webhooks required - Webhooks are required for status updates

Supported countries

Worldpay (WPG) supports transactions from buyers in the following countries:

Country code	Country code	Country code	Country code	Country code	Country code	Country code	Country code	Country code	Country code
AD	AE	AF	AG	AI	AL	AM	AO	AQ	AR
AS	AT	AU	AW	AX	AZ	BA	BB	BD	BE
BF	BG	BH	BI	BJ	BL	BM	BN	BO	BQ
BR	BS	BT	BV	BW	BY	BZ	CA	CC	CD
CF	CG	CH	CI	CK	CL	CM	CN	CO	CR
CU	CV	CW	CX	CY	CZ	DE	DJ	DK	DM
DO	DZ	EC	EE	EG	EH	ER	ES	ET	FI
FJ	FK	FO	FR	GA	GB	GD	GE	GF	GG
GH	GI	GL	GM	GN	GP	GQ	GR	GS	GT
GU	GW	GY	HK	HM	HN	HR	HT	HU	ID
IE	IL	IM	IN	IO	IQ	IR	IS	IT	JE
JM	JO	JP	KE	KG	KH	KI	KM	KN	KP
KR	KW	KY	KZ	LA	LB	LC	LK	LR	LS
LV	LY	MA	MD	ME	MF	MG	MK	MM	MN
MO	MP	MR	MU	MV	MW	MX	MY	MZ	NA
NC	NE	NF	NG	NI	NL	NO	NP	NR	NU
NZ	OM	PA	PE	PF	PG	PH	PK	PL	PM
PN	PR	PS	PT	PW	PY	QA	RE	RO	RS
RU	RW	SA	SB	SC	SD	SE	SG	SH	SI
SJ	SK	SL	SM	SN	SO	SR	ST	SV	SX
SY	SZ	TC	TD	TF	TG	TH	TJ	TK	TL
TM	TN	TO	TR	TT	TV	TW	TZ	UA	UG
UM	US	UY	UZ	VA	VC	VE	VG	VI	VN
VU	WF	WS	YE	ZA	ZM	ZW

Supported currencies

Worldpay (WPG) supports processing payments in the following currencies:

Currency code	Currency code	Currency code	Currency code	Currency code	Currency code	Currency code	Currency code	Currency code	Currency code
AED	AFN	AOA	ARS	AUD	AWG	AZN	BAM	BBD	BDT
BGN	BHD	BIF	BMD	BND	BOB	BRL	BSD	BTN	BWP
BYN	BZD	CAD	CDF	CHF	CLP	CNY	COP	CRC	CVE
CZK	DJF	DKK	DOP	DZD	EGP	ERN	ETB	EUR	FJD
FKP	GBP	GEL	GHS	GIP	GMD	GNF	GTQ	GYD	HKD
HNL	HTG	HUF	IDR	ILS	INR	IQD	IRR	ISK	JMD
JOD	JPY	KES	KHR	KMF	KPW	KRW	KWD	KYD	KZT
LAK	LBP	LKR	LRD	LSL	LYD	MAD	MDL	MGA	MKD
MMK	MNT	MOP	MRU	MUR	MVR	MWK	MXN	MYR	MZN
NAD	NGN	NIO	NOK	NPR	NZD	OMR	PAB	PEN	PGK
PHP	PKR	PLN	PYG	QAR	RON	RSD	RUB	RWF	SAR
SBD	SCR	SEK	SGD	SHP	SOS	SRD	SVC	SYP	SZL
THB	TJS	TMT	TND	TOP	TRY	TTD	TWD	TZS	UAH
UGX	USD	UYU	UZS	VND	VUV	WST	XAF	XCD	XCG
XOF	XPF	YER	ZAR	ZMW

Limitations

The following features are not supported by this connector:

• Over capture - Capturing more than the authorized amount is not supported
• Partial authorization - Partial authorization is not supported
• Payment method tokenization - Storing payment methods outside of transactions using a separate tokenization flow
• Settlement reporting - Automatic settlement reporting is not supported

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.