Integrating Worldpay (FIS)
Auth: OAuth 2.0 (client credentials) · Partner program: not required · Setup time: about 20 minutes · Last verified: 2026-05-15
Enterprise EMEA + global card gateway under FIS. Two API surfaces co-exist:
- Worldpay Access REST API — modern JSON. What this adapter uses.
- Worldpay Corporate Gateway (SOAP) — legacy XML over POST. Used by long-running merchants on Worldpay Business Gateway. Not supported by this adapter.
Auth model
Section titled “Auth model”Either:
- HTTP Basic (username + password from the Worldpay portal), or
- OAuth 2.0 client-credentials (Worldpay for Platforms; partner-program-gated).
The adapter accepts either set on the Connect Link form; submit one or the other.
Required adapter quirks
Section titled “Required adapter quirks”- Versioned media type. Every request asks for
application/vnd.worldpay.payments-v7+json. Bump inconstants.tsafter re-testing. - Try host (
try.access.worldpay.com) is the developer playground — sandbox-of-the-sandbox. Use it for early integration; flip toaccess-uat.worldpay.comfor full UAT, thenaccess.worldpay.comfor live. outcome≠lastEvent. Worldpay reports a high-leveloutcomeplus a stream of state-transition events. The adapter mapsoutcomefirst, falling back tolastEventfor derived state.
Webhooks
Section titled “Webhooks”Configure notifications under Webhooks in the Access dashboard. HMAC-SHA-256 of the raw body keyed with the webhook secret; the signature ships in Worldpay-Webhook-Signature as v1=….
References
Section titled “References”- Access platform overview: https://docs.worldpay.com/access/products/access
- Payments API reference (OpenAPI): https://docs.worldpay.com/access/products/payments/openapi
- Events / webhook notifications reference: https://docs.worldpay.com/access/products/events/openapi
- API catalogue (all Access products): https://docs.worldpay.com/access/apis
- Legacy SOAP gateway (not supported by this adapter): https://developerengine.fisglobal.com/apis/wpg
opensteward.dev ·Plans and free license ·Terms ·Privacy ·support@opensteward.dev
© 2026 Falco Consulting AB. Built from open-steward/opensteward@a3961d8. This site sets no cookies, runs no analytics and loads nothing from other sites, except platform logos from Brandfetch on the Platforms page.