**Last updated**: 17 October 2025 | [**Change log**](/products/payment-queries/changelog/)

# 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](/products/payment-queries/query-archive).

## 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-bsh.securedataplatform.com/paymentQueries/payments/{paymentId}`

### Example

`GET` `https://try.access.worldpay-bsh.securedataplatform.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

### Response example

{
  "timestamp":"2025-06-08T16:11:13.164Z",
  "paymentId":"payVGX28GOT7iDY5qanttPWF0",
  "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-bsh.securedataplatform.com/payments/events/{linkData}"
    },
    "payments:partialRefund":{
      "href":"https://access.worldpay-bsh.securedataplatform.com/payments/settlements/refunds/partials/{linkData}"
    }
  }
}