**Last updated**: 10 February 2026 | [**Change log**](/access/products/card-payments/changelog/)

# 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


## Using the events action link from your response

1. You receive a `payments:events` action link in your:
  - [Authorization response](/access/products/card-payments/authorize-a-payment#authorization-responses)
  - [Settle response](/access/products/card-payments/manage-payments#settle-response)
  - [Refund response ](/access/products/card-payments/manage-payments#full-refund-response)
  - [Cancel response](/access/products/card-payments/manage-payments#cancel-response)
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](/access/products/payment-queries/).
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`
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
        }]
    }
}