Skip to content

Last updated: 11 November 2025 | Change log

Query a Payment

Send a request to find out the current status of your payment after it has been authorized.

Note

It can take up to 15 minutes for a payment event to update.

How it works

There's two ways you can query a payment:

  • the payments:events action link from your response
  • the payments event resource which takes transactionRef and entity as query parameters

  1. You receive a payments:events action link in your:

  2. Make a GET request on the action link that's received in your request:
    GET https://try.access.worldpay.com/payments/events/eyJrIjoiazNhYjYzMiJ9

  3. We return the last event and your next available actions.

The response

{
    "lastEvent": "Authorized",
    "_links": {
        "payments:cancel": {
            "href": "https://try.access.worldpay.com/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiJ9"
        },
        "cardPayments:partialCancel": {
            "href": "https://try.access.worldpay.com/payments/authorizations/cancellations/partials/eyJrIjoiazNhYjYzMiJ9"
        },        
        "payments:settle": {
            "href": "https://try.access.worldpay.com/payments/settlements/full/eyJrIjoiazNhYjYzMiJ9"
        },
        "payments:partialSettle": {
            "href": "https://try.access.worldpay.com/payments/settlements/partials/eyJrIjoiazNhYjYzMiJ9"
        },
        "curies": [{
            "name": "payments",
            "href": "https://try.access.worldpay.com/rels/payments/{rel}",
            "templated": true
        }]
    }
}

Using the transaction reference and entity

Warning

Only use this for recovery purposes for example when your authorization request has timed out or you are unable to locate a payment through our Payment Queries API. If the query returns results, you can manage the payment using the next action links returned in the response of your GET request.

  1. You make a query using the transactionReference and entity parameters:
    GET https://try.access.worldpay.com/payments/events?transactionRef=REF123&entity=default

    Note

    Replace REF123 with the unique transactionReference used in your authorization request and replace default with your merchant entity.

  2. We return the lastEvent and your next available actions.

The response

{
    "lastEvent": "Authorized",
    "_links": {
        "payments:cancel": {
            "href": "https://try.access.worldpay.com/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiJ9"
        },
        "cardPayments:partialCancel": {
            "href": "https://try.access.worldpay.com/payments/authorizations/cancellations/partials/eyJrIjoiazNhYjYzMiJ9"
        },        
        "payments:settle": {
            "href": "https://try.access.worldpay.com/payments/settlements/full/eyJrIjoiazNhYjYzMiJ9"
        },
        "payments:partialSettle": {
            "href": "https://try.access.worldpay.com/payments/settlements/partials/eyJrIjoiazNhYjYzMiJ9"
        },
        "curies": [{
            "name": "payments",
            "href": "https://try.access.worldpay.com/rels/payments/{rel}",
            "templated": true
        }]
    }
}