**Last updated**: 11 November 2025 | [**Change log**](/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](/products/card-payments/authorize-a-payment#authorization-responses)
  - [Settle response](/products/card-payments/manage-payments#settle-response)
  - [Refund response ](/products/card-payments/manage-payments#full-refund-response)
  - [Cancel response](/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-bsh.securedataplatform.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-bsh.securedataplatform.com/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiJ9"
        },
        "cardPayments:partialCancel": {
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/authorizations/cancellations/partials/eyJrIjoiazNhYjYzMiJ9"
        },        
        "payments:settle": {
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/settlements/full/eyJrIjoiazNhYjYzMiJ9"
        },
        "payments:partialSettle": {
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/settlements/partials/eyJrIjoiazNhYjYzMiJ9"
        },
        "curies": [{
            "name": "payments",
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/rels/payments/{rel}",
            "templated": true
        }]
    }
}

## Using the transaction reference and entity

Note
This action is only to be used for recovery purposes. Use this action if your authorization requests timed out. The response determines if your authorization request was successful and your next available actions are returned.

1. You make a query using the transactionReference and entity parameters:
`GET`  `https://try.access.worldpay-bsh.securedataplatform.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-bsh.securedataplatform.com/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiJ9"
        },
        "cardPayments:partialCancel": {
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/authorizations/cancellations/partials/eyJrIjoiazNhYjYzMiJ9"
        },        
        "payments:settle": {
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/settlements/full/eyJrIjoiazNhYjYzMiJ9"
        },
        "payments:partialSettle": {
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/settlements/partials/eyJrIjoiazNhYjYzMiJ9"
        },
        "curies": [{
            "name": "payments",
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/rels/payments/{rel}",
            "templated": true
        }]
    }
}