Last updated: 17 October 2025 | Change log

Retrieve a payment by payment ID

Provide the paymentId for a card payment to retrieve all information about the payment.

Note

The API returns detailed data for payments processed after 25 June 2024. For payments processed before then, you can query for historical payments.

Request

Retrieve a payment using the unique paymentId generated for each payment. The date range query response contains a paymentId for every payment. You can use this to retrieve detailed payment information along with list of events.

GET https://try.access.worldpay.com/paymentQueries/payments/{paymentId}

Example

GET https://try.access.worldpay.com/paymentQueries/payments/paycGeAtsYssrrtgieKBA3Pi0

Parameter description

Parameter	Required	Description
`paymentId`	✅	A unique `paymentId` generated for each payment.

Response

The response contains detailed information about the payment associated with the paymentId. This includes the event history and next action links.

If the paymentId does not exist then an empty response will be returned.

Response schema

timestampstring

Payment initial authorization time.

Example: "2024-05-30T09:49:45.962Z"

paymentIdstring(paymentId)[ 25 .. 36 ] characters^[A-Za-z0-9_-]*$

Unique identifier generated by us for a single payment. Generated at authorization, and maintained through successive payment actions.

Example: "pay4u_lHl2jobU5S1T2pWkq10"

transactionReferencestring[ 1 .. 64 ] characters^[-A-Za-z0-9_!@#$%()*=.:;?\[\]{}~`/+]*$

A unique reference generated by you, used to identify a payment throughout its lifecycle.

narrativeobject

The text that appears on your customer's statement. Used to identify the merchant.

transactionTypestring

The transaction type of the payment.

Enum"oneTime""cardOnFile""recurring"

authorizationTypestring

The authorization type of the payment.

Enum"authorization""sale"

entitystring[ 1 .. 32 ] characters^([A-Za-z0-9]+[A-Za-z0-9 ]*)?$

Merchant entity name.

Example: "default"

lastEventstring(lastEvent)

The last event received for the payment

Enum Value	Description
authorizationRequested	Worldpay has received your authorization request.
authorizationSucceeded	Your authorization request was successfully approved by the card issuer.
authorizationRefused	Your authorization request was refused by the card issuer.
authorizationFailed	Your authorization request failed.
authorizationTimedOut	Your authorization request timed out.
saleRequested	Worldpay has received your sale request.
saleSucceeded	Your sale request was successfully approved by the card issuer.
saleRefused	Your sale request was refused by the card issuer.
saleFailed	Your sale request failed.
saleTimedOut	Your sale request timed out.

Example: "authorizationSucceeded"

schemeobject

An object containing information returned by the card scheme.

issuerobject

An object containing information returned by the issuer.

paymentInstrumentobject

The payment instrument supplied in the authorization request.

updatedPaymentInstrumentobject

The payment instrument supplied in the authorization request.

valueobject

An object that contains payment amount and currency.

eventsArray of objects

An array that contains the history of events of a payment.

_linksobject

Self link and next action links.

Response example

{
  "timestamp":"2025-06-08T16:11:13.164Z",
  "transactionReference":"89197aeb-c94a-456e-8014-1272fbcb64eb",
  "narrative":{
    "line1":"trading name",
    "line2":"order number"
  },
  "transactionType":"oneTime",
  "authorizationType":"authorization",
  "lastEvent": "refundRequestSubmitted",
  "entity":"default",
  "issuer":{
    "authorizationCode":"T31306"
  },
  "scheme":{
    "reference":"MCCOLXT1C0104  "
  },
  "paymentInstrument":{
    "type":"card/plain+masked",
    "card":{
      "number":{
        "last4Digits":"1111",
        "cardBin":"444433"
      },
      "brand":"visa",
      "expiryDate":{
        "month":5,
        "year":2030
      },
      "countryCode":"GB",
      "fundingType":"credit",
      "issuerName":"AN ISSUING BANK LTD",
      "paymentAccountReference":"Q1HJZ28RKA1EBL470G9XYG90R5D3E",
      "category":"consumer"
    }
  },
  "value":{
    "currency":"GBP",
    "amount":1200
  },
  "events":[
    {
      "eventName":"authorizationRequested",
      "timestamp":"2025-06-08T16:11:13.164Z"
    },
    {
      "eventName":"authorizationSucceeded",
      "timestamp":"2025-06-08T16:11:14.229Z",
      "outcome":"authorized"
    },
    {
      "eventName":"settlementRequested",
      "timestamp":"2025-06-09T08:14:23.138Z",
      "type":"partialSettlement",
      "settlementReference":"mySettleRef",
      "value":{
        "currency":"GBP",
        "amount":1000
      }
    },
    {
      "eventName":"settlementRequestSubmitted",
      "timestamp":"2025-06-09T08:14:23.224Z"
    },
    {
      "eventName":"refundRequested",
      "timestamp":"2025-07-01T09:14:28.009Z",
      "type":"partialRefund",
      "refundReference":"myRefundRef",
      "value":{
        "currency":"GBP",
        "amount":1000
      }
    },
    {
      "eventName":"refundRequestSubmitted",
      "timestamp":"2025-07-01T09:14:28.151Z"
    }
  ],
  "_links":{
    "self":{
      "href":"/paymentQueries/payments/payVGX28GOT7iDY5qanttPWF0"
    },
    "payments:events":{
      "href":"https://access.worldpay.com/payments/events/{linkData}"
    },
    "payments:partialRefund":{
      "href":"https://access.worldpay.com/payments/settlements/refunds/partials/{linkData}"
    }
  }
}