Skip to content
APIs/Card Payments/Query a payment

Query a payment

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

Operations

Query payment status

Request

Send a request to find out the current status of your payment after it has been authorized using the events action link. Note: It can take up to 15 minutes for a payment event to update.

Security
BasicAuth
Path
linkDatastringrequired

Action link that's received in your request

curl -i -X GET \
  -u '<username>:<password>' \
  'https://try.access.worldpay.com/payments/events/{linkData}'

Responses

Retrieve the last event of a payment

Bodyapplication/vnd.worldpay.payments-v6.hal+json
lastEventstringrequired
Response

Querying a payment event with a transaction reference REF123

{
  "lastEvent": "Authorized",
  "_links": {
    "payments:cancel": "/payments/authorizations/cancellations/:linkData",
    "payments:settle": "/payments/settlements/full/:linkData",
    "payments:partialSettle": "/payments/settlements/partials/:linkData",
    "curies": [
      {
        "name": "payments",
        "href": "/rels/payments/{rel}",
        "templated": true
      }
    ]
  }
}