Receive status updates from Access Worldpay by setting up a webhook.

What is a webhook?

Access Worldpay webhooks provide you with real-time information about the status of your requests. Setting up a webhook means you automatically receive updates when there is a status change with your request.

Boarding with Worldpay

Log into yourdashboardand enable or disable theeventsbased on your requirements.

Note: The webhook destination (URL) must use an encrypted connection (https) and must also have a certificate signed by a trusted certificate authority.

Receiving the webhook

Network access

The webhooks originate from the following set of IP addresses and the HTTPS port; 443. Ensure your Web Application Firewall (WAF) allows the webhooks to be received for the following addresses. The full set of IP’s must be whitelisted for each of your environments.

IP list


Event acknowledgement

Respond with a HTTP(S) response code 200 to confirm you've received the event.

Warning: Not acknowledging can cause delays (or loss) of subsequent events in the queue.

  • If a 200 event confirmation response is not received within 10 seconds, we retry the event until the confirmation is received.
  • Retry intervals increase based on the number of attempts, the time intervals increase starting 15 minutes to 2 hours per event.
  • The retry mechanism stops re-sending each event after either; an acknowledgement (200) is received, or after one week of attempting to send the event.

Events supported

Payment events

Webhook values

eventIdThe unique identifier for the event.
eventTimestampDate of event.
eventDetailsAn object that contains event information.
classificationThe event category, value= "payment".
transactionReferenceThe transaction reference you supplied in the payment.
typeEvent status. For example, cancelled or sentForAuthorization.
dateThe date you first submitted the payment.
referenceThe unique reference you provided for a partial settlement or partial refund.
refund.onlineRefundAuthorizationAuthorization code from the issuer for online refunds.

Note: Additional information returned as part of a Visa and Mastercard mandate to ensure that all purchase returns are submitted for online authorization. Will be progressively introduced for all regions up until April 2022.

refund.refusal.codeRefusal code for online refund authorization.
refund.refusal.descriptionRefusal description for online refund authorization.
amountAn object containing the value and currencyCode.
valueThe authorization, partial refund, or the whole or partial settlement amount. This is a whole number with an exponent of 2 e.g. 250 would be 2.50.
currencyCodeThecurrency code.
_linksUnused currently