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

# Query historical payments

Query card payments processed before 25 June 2024.

## Request

Provide a `transactionReference` and `entityReference` to find the matching payment.

`GET` `https://try.access.worldpay-bsh.securedataplatform.com/paymentQueries/archivedPayments?transactionReference={transactionReference}&entityReference={entityReference}`

### Example

`GET` `https://try.access.worldpay-bsh.securedataplatform.com/paymentQueries/archivedPayments?transactionReference=PayFac20230302-3charState&entity=entityReference123`

### Parameter descriptions

| Parameter | Required | Description |
|  --- | --- | --- |
| `transactionReference` | ✅ | A **unique** reference generated by you. It is used to identify a payment throughout its lifecycle. |
| `entityReference` | ✅ | Direct your payment to assist with billing, reporting and reconciliation. This is mandatory for authentication of a payment.Contact your Implementation Manager for more details.  You might have supplied this as `entity` in your original payment request.  |


The response contains summary information about the payment associated with the request parameters.

## Response

### Response schema

### Response examples

Authorized

```json
{
    "_embedded": {
        "payments": [
            {
                "lastEvent": "Authorized",
                "value": {
                    "amount": 500,
                    "currency": "GBP"
                },
                "paymentInstrument": {
                    "type": "card/plain",
                    "card": {
                        "number": {
                            "last4Digits": "1111"
                        },
                        "brand": "visa"
                    }
                },
                "_links": {
                    "payments:cancel": {
                        "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNS4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:miQ42Na870582T9ERg+1ZUryhkE+qW88hu1DdDl2T76sf:VXab5cMYWO6LS0UzlfoW8PkXm9A8Gx:X:2vAwKFXFzKnt23AOHd1MAcGi2rYDmNWql5dV+zBj9zyT7GZXrLmjasoJJfxtEasqXGr:dzHa6q9jMukzvEX+SLmppl6itAGDMxqvmBKsIqEipLj126"
                    },
                    "payments:settle": {
                        "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/settlements/full/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNS4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:miQ42Na870582T9ERg+1ZUryhkE+qW88hu1DdDl2T76sf:VXab5cMYWO6LS0UzlfoW8PkXm9A8Gx:X:2vAwKFXFzKnt23AOHd1MAcGi2rYDmNWql5dV+zBj9zyT7GZXrLmjasoJJfxtEasqXGr:dzHa6q9jMukzvEX+SLmppl6itAGDMxqvmBKsIqEipLj126"
                    },
                    "payments:partialSettle": {
                        "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/settlements/partials/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNS4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:miQ42Na870582T9ERg+1ZUryhkE+qW88hu1DdDl2T76sf:VXab5cMYWO6LS0UzlfoW8PkXm9A8Gx:X:2vAwKFXFzKnt23AOHd1MAcGi2rYDmNWql5dV+zBj9zyT7GZXrLmjasoJJfxtEasqXGr:dzHa6q9jMukzvEX+SLmppl6itAGDMxqvmBKsIqEipLj126"
                    }
                }
            }
        ]
    },
    "_links": {
        "self": {
            "href": "/paymentQueries/archivedPayments?entityReference=AccessWP&transactionReference=Test123"
        }
    }
}
```

Sent for cancellation

```json
{
    "_embedded": {
        "payments": [
            {
                "lastEvent": "Sent for Cancellation",
                "value": {
                    "amount": 310,
                    "currency": "GBP"
                },
                "paymentInstrument": {
                    "type": "card/plain",
                    "card": {
                        "number": {
                            "last4Digits": "4444"
                        },
                        "brand": "mastercard"
                    }
                }
            }
        ]
    },
    "_links": {
        "self": {
            "href": "/paymentQueries/archivedPayments?entityReference=AccessWP&transactionReference=test111"
        }
    }
}
```

Refused

```json
{
    "_embedded": {
        "payments": [
            {
                "lastEvent": "Refused",
                "value": {
                    "amount": 310,
                    "currency": "GBP"
                },
                "paymentInstrument": {
                    "type": "card/plain",
                    "card": {
                        "number": {
                            "last4Digits": "4444"
                        },
                        "brand": "mastercard"
                    }
                },
                "_links": {
                    "payments:refund": {
                        "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/settlements/refunds/full/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNS4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mAEt7xeLgrG3DmyZ+KdP10YlVEr5e6EVc4iYqaYytIPYf:VXab5cMYWO6LS0UzlfoW8PkXm9A8Gx:X:2vAwKFXFzKnt23AOHd1MAcGi2rYDmNWql5dV+zBj9zyT7GZXrLmjasoJJfxtEasqXGr:dzHXp1nU+oBzi04ZLL+c8GFiU="
                    },
                    "payments:partialRefund": {
                        "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/settlements/refunds/partials/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNS4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mAEt7xeLgrG3DmyZ+KdP10YlVEr5e6EVc4iYqaYytIPYf:VXab5cMYWO6LS0UzlfoW8PkXm9A8Gx:X:2vAwKFXFzKnt23AOHd1MAcGi2rYDmNWql5dV+zBj9zyT7GZXrLmjasoJJfxtEasqXGr:dzHXp1nU+oBzi04ZLL+c8GFiU="
                    },
                    "payments:reversal": {
                        "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/sales/reversals/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNS4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mAEt7xeLgrG3DmyZ+KdP10YlVEr5e6EVc4iYqaYytIPYf:VXab5cMYWO6LS0UzlfoW8PkXm9A8Gx:X:2vAwKFXFzKnt23AOHd1MAcGi2rYDmNWql5dV+zBj9zyT7GZXrLmjasoJJfxtEasqXGr:dzHXp1nU+oBzi04ZLL+c8GFiU="
                    }
                }
            }
        ]
    },
    "_links": {
        "self": {
            "href": "/paymentQueries/archivedPayments?entityReference=AccessWP&transactionReference=test444"
        }
    }
}
```

Sent for settlement

```json
{
    "_embedded": {
        "payments": [
            {
                "lastEvent": "Sent for Settlement",
                "value": {
                    "amount": 310,
                    "currency": "GBP"
                },
                "paymentInstrument": {
                    "type": "card/plain",
                    "card": {
                        "number": {
                            "last4Digits": "4444"
                        },
                        "brand": "mastercard"
                    }
                },
                "_links": {
                    "payments:refund": {
                        "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/settlements/refunds/full/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNS4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mPhJbP6pkC5Wn5uXMTHs8Y4lVEr5e6EVc4iYqaYytIPYf:VXab5cMYWO6LS0UzlfoW8PkXm9A8Gx:X:2vAwKFXFzKnt23AOHd1MAcGi2rYDmNWql5dV+zBj9zyT7GZXrLmjasoJJfxtEasqXGr:dzHXp1nU+oBzi04ZLL+c8GFiU="
                    },
                    "payments:partialRefund": {
                        "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/settlements/refunds/partials/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNS4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mPhJbP6pkC5Wn5uXMTHs8Y4lVEr5e6EVc4iYqaYytIPYf:VXab5cMYWO6LS0UzlfoW8PkXm9A8Gx:X:2vAwKFXFzKnt23AOHd1MAcGi2rYDmNWql5dV+zBj9zyT7GZXrLmjasoJJfxtEasqXGr:dzHXp1nU+oBzi04ZLL+c8GFiU="
                    },
                    "payments:reversal": {
                        "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/sales/reversals/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNS4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mPhJbP6pkC5Wn5uXMTHs8Y4lVEr5e6EVc4iYqaYytIPYf:VXab5cMYWO6LS0UzlfoW8PkXm9A8Gx:X:2vAwKFXFzKnt23AOHd1MAcGi2rYDmNWql5dV+zBj9zyT7GZXrLmjasoJJfxtEasqXGr:dzHXp1nU+oBzi04ZLL+c8GFiU="
                    }
                }
            }
        ]
    },
    "_links": {
        "self": {
            "href": "/paymentQueries/archivedPayments?entityReference=AccessWP&transactionReference=test222"
        }
    }
}
```

Sent for refund

```json
{
    "_embedded": {
        "payments": [
            {
                "lastEvent": "Sent for Refund",
                "value": {
                    "amount": 500,
                    "currency": "GBP"
                },
                "paymentInstrument": {
                    "type": "card/plain",
                    "card": {
                        "number": {
                            "last4Digits": "1111"
                        },
                        "brand": "visa"
                    }
                }
            }
        ]
    },
    "_links": {
        "self": {
            "href": "/paymentQueries/archivedPayments?entityReference=AccessWP&transactionReference=AtiqTest5thJulyRefund"
        }
    }
}
```