{
"openapi": "3.0.1",
"info": {
"title": "Payment Queries",
"version": "1",
"x-metadata": {
"category": [
"Query Payments"
],
"business": [
"Enterprise"
],
"catalog-list": true,
"generated": false
},
"description": "Query your payments data based on a variety of parameters.\n\n__Authentication__ \n\nSet your headers:\n\n ```\n Authorization: {your_credentials}\n Accept: application/vnd.worldpay.payment-queries-v1.hal+json\n ```\nReplace `{your_credentials}` with your base64-encoded Basic Auth username and password.\n\n
\n__DNS whitelisting__\n\nWhitelist the following URLs:\n* `https://try.access.worldpay-bsh.securedataplatform.co.uk/`\n* `https://access.worldpay-bsh.securedataplatform.co.uk/`\n\nPlease ensure you use DNS whitelisting, not explicit IP whitelisting."
},
"servers": [
{
"url": "https://try.access.worldpay-bsh.securedataplatform.co.uk",
"description": "Test (Try)"
},
{
"url": "https://access.worldpay-bsh.securedataplatform.co.uk",
"description": "Live"
}
],
"paths": {
"/paymentQueries/payments": {
"get": {
"summary": "Query payments",
"description": "Query payments within a specified date time range.\n\nThese payments can be filtered by currency, minAmount, maxAmount, last4Digits & receivedEvents.\n\nThe API returns data for payments processed after 25 June 2024. For payments processed before then use our [query for historical payments](/products/payment-queries/@v1/query-archive.md).",
"operationId": "queryByDateRange",
"parameters": [
{
"in": "header",
"name": "Accept",
"required": true,
"schema": {
"type": "string",
"example": "application/vnd.worldpay.payment-queries-v1.hal+json"
}
},
{
"name": "startDate",
"in": "query",
"description": "An ISO 8601 date-time supplied as a string. Filters for payments that occurred after the specified date-time. Must be supplied alongside endDate.",
"required": true,
"schema": {
"type": "string",
"example": "2024-04-28T21:30:20Z"
}
},
{
"name": "endDate",
"in": "query",
"description": "An ISO 8601 date-time supplied as a string. Filters for payments that occurred below the specified date-time. Must be supplied alongside startDate.",
"required": true,
"schema": {
"type": "string",
"example": "2024-05-31T21:30:20Z"
}
},
{
"name": "pageSize",
"in": "query",
"description": "The maximum number of payments to be returned in the response (max 300).",
"required": false,
"schema": {
"maxLength": 300,
"type": "integer",
"example": 10
}
},
{
"name": "currency",
"in": "query",
"description": "The three digit currency code.",
"required": false,
"schema": {
"type": "string",
"example": "GBP"
}
},
{
"name": "minAmount",
"in": "query",
"description": "This is a whole number including the currency exponent (e.g. GBP has an exponent of 2, so for £2.50 supply:`250`).",
"required": false,
"schema": {
"type": "integer",
"example": 0
}
},
{
"name": "maxAmount",
"in": "query",
"description": "This is a whole number including the currency exponent (e.g. GBP has an exponent of 2, so for £2.50 supply:`250`).",
"required": false,
"schema": {
"type": "integer",
"example": 1000
}
},
{
"name": "last4Digits",
"in": "query",
"description": "The last four digits of the card number.",
"required": false,
"schema": {
"type": "string",
"example": "1111"
}
},
{
"name": "entityReferences",
"in": "query",
"description": "Your entity reference(s).",
"required": false,
"schema": {
"type": "string",
"example": "entityReference1,entityReference2"
}
},
{
"name": "receivedEvents",
"in": "query",
"description": "Name of the event.",
"required": false,
"schema": {
"type": "string",
"example": "authorizationRequested, authorizationSucceeded"
}
},
{
"name": "transactionReference",
"in": "query",
"description": "A unique reference generated by you, used to identify a payment throughout its lifecycle. This shouldn't be used in conjunction with the above fields. Use it as a single parameter to query data.",
"required": false,
"schema": {
"type": "string",
"example": "Memory265-13/08/1876"
}
},
{
"name": "orderReference",
"in": "query",
"description": "A reference, generated by you, that you can apply to one or more payments according to your business needs. You may reuse the same reference across multiple payments, for example where:\n- the total amount for a single order is split across multiple payments\n- you use a single reference for each payment in a recurring agreement or split shipment scenario \n\nThis shouldn't be used in conjunction with the above fields. Use it as a single parameter to query data.\n\n**Note**: Querying by orderReference returns data for payments processed after 20 August 2026.",
"required": false,
"schema": {
"type": "string",
"example": "order-12345"
}
}
],
"responses": {
"200": {
"description": "Summary information of list of payments within a specified date range.",
"content": {
"application/vnd.worldpay.payment-queries-v1.hal+json": {
"schema": {
"$ref": "#/components/schemas/pq_querybydaterange_200_response"
},
"examples": {
"Query payments within a specified date time range": {
"description": "Query payments within a specified date time range",
"value": {
"_links": {
"self": {
"href": "/paymentQueries/payments?startDate=2026-08-17T21:30:20Z&endDate=2026-08-19T21:30:20Z&pageSize=10"
},
"next": {
"href": "/paymentQueries/payments?startDate=2026-08-17T21:30:20Z&endDate=2026-08-19T13:44:26.328Z&paymentId=pay4Vx0Ft1OYWtXq-43OrZdy0&pageSize=10"
}
},
"_embedded": {
"payments": [
{
"timestamp": "2026-08-19T13:47:52.365Z",
"paymentId": "payOoT928hHR9OwZh-iisTuR0",
"transactionReference": "78f1c782-2816-45ca-bb1f-c46e789a9c81",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payOoT928hHR9OwZh-iisTuR0"
}
}
},
{
"timestamp": "2026-08-19T13:44:43.630Z",
"paymentId": "payxrP-FyWbsg-Xs0QZL9WK-0",
"transactionReference": "07689df2-7e68-4e94-828c-3a43c38fae4c",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "262033"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payxrP-FyWbsg-Xs0QZL9WK-0"
}
}
},
{
"timestamp": "2026-08-19T13:44:40.924Z",
"paymentId": "paydyrGHSMWynO_V0b1ZAKHb0",
"transactionReference": "c5180092-fa58-4771-9770-108aafadd6ac",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "922641"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paydyrGHSMWynO_V0b1ZAKHb0"
}
}
},
{
"timestamp": "2026-08-19T13:44:38.161Z",
"paymentId": "paygSAoftgF_bjP7FCUCbhRQ0",
"transactionReference": "6cc5d236-116c-4132-a075-41aaa0fdd8c8",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "305730"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paygSAoftgF_bjP7FCUCbhRQ0"
}
}
},
{
"timestamp": "2026-08-19T13:44:36.934Z",
"paymentId": "payiMoeQ5me59ykcLi4Op14m0",
"transactionReference": "58ded0e2-bc44-4ae9-8cb1-e00d9b7386f9",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "793150"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payiMoeQ5me59ykcLi4Op14m0"
}
}
},
{
"timestamp": "2026-08-19T13:44:33.209Z",
"paymentId": "paye_Xb84SCoQVodEMOLQEs10",
"transactionReference": "e9b50c9a-ae4e-4afb-ab8a-721af781bf05",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "393558"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paye_Xb84SCoQVodEMOLQEs10"
}
}
},
{
"timestamp": "2026-08-19T13:44:31.966Z",
"paymentId": "paynRxC16ALQ7UiCKWGaJGSf0",
"transactionReference": "09dc405c-7d5e-4176-a2f1-43f387bd3744",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "701855"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paynRxC16ALQ7UiCKWGaJGSf0"
}
}
},
{
"timestamp": "2026-08-19T13:44:29.996Z",
"paymentId": "payGlJwNBPaqGtGva7CCzhb40",
"transactionReference": "b199db6b-adf8-4d48-ba87-2b3aff95760e",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "500160"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payGlJwNBPaqGtGva7CCzhb40"
}
}
},
{
"timestamp": "2026-08-19T13:44:28.005Z",
"paymentId": "payiD5ku26v8X1QE454fQc250",
"transactionReference": "6855dd44-743f-4cbc-aebc-804f3cb3cd8a",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "962017"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payiD5ku26v8X1QE454fQc250"
}
}
},
{
"timestamp": "2026-08-19T13:44:26.328Z",
"paymentId": "pay4Vx0Ft1OYWtXq-43OrZdy0",
"transactionReference": "1b5a7757-1a32-441a-b06c-18574eee4014",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "406747"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/pay4Vx0Ft1OYWtXq-43OrZdy0"
}
}
}
]
}
}
},
"Query payments within a specified date time range filtered by currency": {
"description": "Query payments within a specified date time range filtered by currency",
"value": {
"_links": {
"self": {
"href": "/paymentQueries/payments?startDate=2026-08-17T21:30:20Z&endDate=2026-08-19T21:30:20Z¤cy=GBP&pageSize=10"
},
"next": {
"href": "/paymentQueries/payments?startDate=2026-08-17T21:30:20Z&endDate=2026-08-19T13:44:26.328Z&paymentId=pay4Vx0Ft1OYWtXq-43OrZdy0¤cy=GBP&pageSize=10"
}
},
"_embedded": {
"payments": [
{
"timestamp": "2026-08-19T13:47:52.365Z",
"paymentId": "payOoT928hHR9OwZh-iisTuR0",
"transactionReference": "78f1c782-2816-45ca-bb1f-c46e789a9c81",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payOoT928hHR9OwZh-iisTuR0"
}
}
},
{
"timestamp": "2026-08-19T13:44:43.630Z",
"paymentId": "payxrP-FyWbsg-Xs0QZL9WK-0",
"transactionReference": "07689df2-7e68-4e94-828c-3a43c38fae4c",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "262033"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payxrP-FyWbsg-Xs0QZL9WK-0"
}
}
},
{
"timestamp": "2026-08-19T13:44:40.924Z",
"paymentId": "paydyrGHSMWynO_V0b1ZAKHb0",
"transactionReference": "c5180092-fa58-4771-9770-108aafadd6ac",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "922641"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paydyrGHSMWynO_V0b1ZAKHb0"
}
}
},
{
"timestamp": "2026-08-19T13:44:38.161Z",
"paymentId": "paygSAoftgF_bjP7FCUCbhRQ0",
"transactionReference": "6cc5d236-116c-4132-a075-41aaa0fdd8c8",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "305730"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paygSAoftgF_bjP7FCUCbhRQ0"
}
}
},
{
"timestamp": "2026-08-19T13:44:36.934Z",
"paymentId": "payiMoeQ5me59ykcLi4Op14m0",
"transactionReference": "58ded0e2-bc44-4ae9-8cb1-e00d9b7386f9",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "793150"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payiMoeQ5me59ykcLi4Op14m0"
}
}
},
{
"timestamp": "2026-08-19T13:44:33.209Z",
"paymentId": "paye_Xb84SCoQVodEMOLQEs10",
"transactionReference": "e9b50c9a-ae4e-4afb-ab8a-721af781bf05",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "393558"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paye_Xb84SCoQVodEMOLQEs10"
}
}
},
{
"timestamp": "2026-08-19T13:44:31.966Z",
"paymentId": "paynRxC16ALQ7UiCKWGaJGSf0",
"transactionReference": "09dc405c-7d5e-4176-a2f1-43f387bd3744",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "701855"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paynRxC16ALQ7UiCKWGaJGSf0"
}
}
},
{
"timestamp": "2026-08-19T13:44:29.996Z",
"paymentId": "payGlJwNBPaqGtGva7CCzhb40",
"transactionReference": "b199db6b-adf8-4d48-ba87-2b3aff95760e",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "500160"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payGlJwNBPaqGtGva7CCzhb40"
}
}
},
{
"timestamp": "2026-08-19T13:44:28.005Z",
"paymentId": "payiD5ku26v8X1QE454fQc250",
"transactionReference": "6855dd44-743f-4cbc-aebc-804f3cb3cd8a",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "962017"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payiD5ku26v8X1QE454fQc250"
}
}
},
{
"timestamp": "2026-08-19T13:44:26.328Z",
"paymentId": "pay4Vx0Ft1OYWtXq-43OrZdy0",
"transactionReference": "1b5a7757-1a32-441a-b06c-18574eee4014",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "406747"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/pay4Vx0Ft1OYWtXq-43OrZdy0"
}
}
}
]
}
}
},
"Query payments within a specified date time range filtered by currency, amount": {
"description": "Query payments within a specified date time range filtered by currency, amount",
"value": {
"_links": {
"self": {
"href": "/paymentQueries/payments?startDate=2026-08-17T21:30:20Z&endDate=2026-08-19T21:30:20Z&minAmount=300&maxAmount=650¤cy=GBP&pageSize=10"
},
"next": {
"href": "/paymentQueries/payments?startDate=2026-08-17T21:30:20Z&endDate=2026-08-19T13:44:26.328Z&paymentId=pay4Vx0Ft1OYWtXq-43OrZdy0&minAmount=300&maxAmount=650¤cy=GBP&pageSize=10"
}
},
"_embedded": {
"payments": [
{
"timestamp": "2026-08-19T13:47:52.365Z",
"paymentId": "payOoT928hHR9OwZh-iisTuR0",
"transactionReference": "78f1c782-2816-45ca-bb1f-c46e789a9c81",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payOoT928hHR9OwZh-iisTuR0"
}
}
},
{
"timestamp": "2026-08-19T13:44:43.630Z",
"paymentId": "payxrP-FyWbsg-Xs0QZL9WK-0",
"transactionReference": "07689df2-7e68-4e94-828c-3a43c38fae4c",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "262033"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payxrP-FyWbsg-Xs0QZL9WK-0"
}
}
},
{
"timestamp": "2026-08-19T13:44:40.924Z",
"paymentId": "paydyrGHSMWynO_V0b1ZAKHb0",
"transactionReference": "c5180092-fa58-4771-9770-108aafadd6ac",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "922641"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paydyrGHSMWynO_V0b1ZAKHb0"
}
}
},
{
"timestamp": "2026-08-19T13:44:38.161Z",
"paymentId": "paygSAoftgF_bjP7FCUCbhRQ0",
"transactionReference": "6cc5d236-116c-4132-a075-41aaa0fdd8c8",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "305730"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paygSAoftgF_bjP7FCUCbhRQ0"
}
}
},
{
"timestamp": "2026-08-19T13:44:36.934Z",
"paymentId": "payiMoeQ5me59ykcLi4Op14m0",
"transactionReference": "58ded0e2-bc44-4ae9-8cb1-e00d9b7386f9",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "793150"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payiMoeQ5me59ykcLi4Op14m0"
}
}
},
{
"timestamp": "2026-08-19T13:44:33.209Z",
"paymentId": "paye_Xb84SCoQVodEMOLQEs10",
"transactionReference": "e9b50c9a-ae4e-4afb-ab8a-721af781bf05",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "393558"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paye_Xb84SCoQVodEMOLQEs10"
}
}
},
{
"timestamp": "2026-08-19T13:44:31.966Z",
"paymentId": "paynRxC16ALQ7UiCKWGaJGSf0",
"transactionReference": "09dc405c-7d5e-4176-a2f1-43f387bd3744",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "701855"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paynRxC16ALQ7UiCKWGaJGSf0"
}
}
},
{
"timestamp": "2026-08-19T13:44:29.996Z",
"paymentId": "payGlJwNBPaqGtGva7CCzhb40",
"transactionReference": "b199db6b-adf8-4d48-ba87-2b3aff95760e",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "500160"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payGlJwNBPaqGtGva7CCzhb40"
}
}
},
{
"timestamp": "2026-08-19T13:44:28.005Z",
"paymentId": "payiD5ku26v8X1QE454fQc250",
"transactionReference": "6855dd44-743f-4cbc-aebc-804f3cb3cd8a",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "962017"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payiD5ku26v8X1QE454fQc250"
}
}
},
{
"timestamp": "2026-08-19T13:44:26.328Z",
"paymentId": "pay4Vx0Ft1OYWtXq-43OrZdy0",
"transactionReference": "1b5a7757-1a32-441a-b06c-18574eee4014",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "406747"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/pay4Vx0Ft1OYWtXq-43OrZdy0"
}
}
}
]
}
}
},
"Query payments within a specified date time range filtered by last4Digits": {
"description": "Query payments within a specified date time range filtered by last4Digits",
"value": {
"_links": {
"self": {
"href": "/paymentQueries/payments?startDate=2026-08-17T21:30:20Z&endDate=2026-08-19T21:30:20Z&minAmount=300&maxAmount=650&last4Digits=1111¤cy=GBP&pageSize=10"
},
"next": {
"href": "/paymentQueries/payments?startDate=2026-08-17T21:30:20Z&endDate=2026-08-19T13:44:26.328Z&paymentId=pay4Vx0Ft1OYWtXq-43OrZdy0&minAmount=300&maxAmount=650&last4Digits=1111¤cy=GBP&pageSize=10"
}
},
"_embedded": {
"payments": [
{
"timestamp": "2026-08-19T13:47:52.365Z",
"paymentId": "payOoT928hHR9OwZh-iisTuR0",
"transactionReference": "78f1c782-2816-45ca-bb1f-c46e789a9c81",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payOoT928hHR9OwZh-iisTuR0"
}
}
},
{
"timestamp": "2026-08-19T13:44:43.630Z",
"paymentId": "payxrP-FyWbsg-Xs0QZL9WK-0",
"transactionReference": "07689df2-7e68-4e94-828c-3a43c38fae4c",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "262033"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payxrP-FyWbsg-Xs0QZL9WK-0"
}
}
},
{
"timestamp": "2026-08-19T13:44:40.924Z",
"paymentId": "paydyrGHSMWynO_V0b1ZAKHb0",
"transactionReference": "c5180092-fa58-4771-9770-108aafadd6ac",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "922641"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paydyrGHSMWynO_V0b1ZAKHb0"
}
}
},
{
"timestamp": "2026-08-19T13:44:38.161Z",
"paymentId": "paygSAoftgF_bjP7FCUCbhRQ0",
"transactionReference": "6cc5d236-116c-4132-a075-41aaa0fdd8c8",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "305730"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paygSAoftgF_bjP7FCUCbhRQ0"
}
}
},
{
"timestamp": "2026-08-19T13:44:36.934Z",
"paymentId": "payiMoeQ5me59ykcLi4Op14m0",
"transactionReference": "58ded0e2-bc44-4ae9-8cb1-e00d9b7386f9",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "793150"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payiMoeQ5me59ykcLi4Op14m0"
}
}
},
{
"timestamp": "2026-08-19T13:44:33.209Z",
"paymentId": "paye_Xb84SCoQVodEMOLQEs10",
"transactionReference": "e9b50c9a-ae4e-4afb-ab8a-721af781bf05",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "393558"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paye_Xb84SCoQVodEMOLQEs10"
}
}
},
{
"timestamp": "2026-08-19T13:44:31.966Z",
"paymentId": "paynRxC16ALQ7UiCKWGaJGSf0",
"transactionReference": "09dc405c-7d5e-4176-a2f1-43f387bd3744",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "701855"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paynRxC16ALQ7UiCKWGaJGSf0"
}
}
},
{
"timestamp": "2026-08-19T13:44:29.996Z",
"paymentId": "payGlJwNBPaqGtGva7CCzhb40",
"transactionReference": "b199db6b-adf8-4d48-ba87-2b3aff95760e",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "500160"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payGlJwNBPaqGtGva7CCzhb40"
}
}
},
{
"timestamp": "2026-08-19T13:44:28.005Z",
"paymentId": "payiD5ku26v8X1QE454fQc250",
"transactionReference": "6855dd44-743f-4cbc-aebc-804f3cb3cd8a",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "962017"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payiD5ku26v8X1QE454fQc250"
}
}
},
{
"timestamp": "2026-08-19T13:44:26.328Z",
"paymentId": "pay4Vx0Ft1OYWtXq-43OrZdy0",
"transactionReference": "1b5a7757-1a32-441a-b06c-18574eee4014",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "406747"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/pay4Vx0Ft1OYWtXq-43OrZdy0"
}
}
}
]
}
}
},
"Query payments within a specified date time range filtered by receivedEvents": {
"description": "Query payments within a specified date time range filtered by receivedEvents",
"value": {
"_links": {
"self": {
"href": "/paymentQueries/payments?startDate=2026-08-17T21:30:20Z&endDate=2026-08-19T21:30:20Z&minAmount=300&maxAmount=650&last4Digits=1111&receivedEvents=authorizationSucceeded¤cy=GBP&pageSize=10"
},
"next": {
"href": "/paymentQueries/payments?startDate=2026-08-17T21:30:20Z&endDate=2026-08-19T10:50:45.392Z&paymentId=payku6vn11Nz5av_tUPw-GyA0&minAmount=300&maxAmount=650&last4Digits=1111&receivedEvents=authorizationSucceeded¤cy=GBP&pageSize=10"
}
},
"_embedded": {
"payments": [
{
"timestamp": "2026-08-19T13:44:43.630Z",
"paymentId": "payxrP-FyWbsg-Xs0QZL9WK-0",
"transactionReference": "07689df2-7e68-4e94-828c-3a43c38fae4c",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "262033"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payxrP-FyWbsg-Xs0QZL9WK-0"
}
}
},
{
"timestamp": "2026-08-19T13:44:40.924Z",
"paymentId": "paydyrGHSMWynO_V0b1ZAKHb0",
"transactionReference": "c5180092-fa58-4771-9770-108aafadd6ac",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "922641"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paydyrGHSMWynO_V0b1ZAKHb0"
}
}
},
{
"timestamp": "2026-08-19T13:44:38.161Z",
"paymentId": "paygSAoftgF_bjP7FCUCbhRQ0",
"transactionReference": "6cc5d236-116c-4132-a075-41aaa0fdd8c8",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "305730"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paygSAoftgF_bjP7FCUCbhRQ0"
}
}
},
{
"timestamp": "2026-08-19T13:44:36.934Z",
"paymentId": "payiMoeQ5me59ykcLi4Op14m0",
"transactionReference": "58ded0e2-bc44-4ae9-8cb1-e00d9b7386f9",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "793150"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payiMoeQ5me59ykcLi4Op14m0"
}
}
},
{
"timestamp": "2026-08-19T13:44:33.209Z",
"paymentId": "paye_Xb84SCoQVodEMOLQEs10",
"transactionReference": "e9b50c9a-ae4e-4afb-ab8a-721af781bf05",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "393558"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paye_Xb84SCoQVodEMOLQEs10"
}
}
},
{
"timestamp": "2026-08-19T13:44:31.966Z",
"paymentId": "paynRxC16ALQ7UiCKWGaJGSf0",
"transactionReference": "09dc405c-7d5e-4176-a2f1-43f387bd3744",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "701855"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paynRxC16ALQ7UiCKWGaJGSf0"
}
}
},
{
"timestamp": "2026-08-19T13:44:29.996Z",
"paymentId": "payGlJwNBPaqGtGva7CCzhb40",
"transactionReference": "b199db6b-adf8-4d48-ba87-2b3aff95760e",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "500160"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payGlJwNBPaqGtGva7CCzhb40"
}
}
},
{
"timestamp": "2026-08-19T13:44:28.005Z",
"paymentId": "payiD5ku26v8X1QE454fQc250",
"transactionReference": "6855dd44-743f-4cbc-aebc-804f3cb3cd8a",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "962017"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payiD5ku26v8X1QE454fQc250"
}
}
},
{
"timestamp": "2026-08-19T13:44:26.328Z",
"paymentId": "pay4Vx0Ft1OYWtXq-43OrZdy0",
"transactionReference": "1b5a7757-1a32-441a-b06c-18574eee4014",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "406747"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/pay4Vx0Ft1OYWtXq-43OrZdy0"
}
}
},
{
"timestamp": "2026-08-19T10:50:45.392Z",
"paymentId": "payku6vn11Nz5av_tUPw-GyA0",
"transactionReference": "7ac302fb-0015-4b61-bf29-ea9f4da11fa1",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "688727"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payku6vn11Nz5av_tUPw-GyA0"
}
}
}
]
}
}
},
"Query payments within a specified date time range filtered by entityReferences": {
"description": "Query payments within a specified date time range filtered by entityReferences",
"value": {
"_links": {
"self": {
"href": "/paymentQueries/payments?startDate=2026-08-17T21:30:20Z&endDate=2026-08-19T21:30:20Z&minAmount=300&maxAmount=650&last4Digits=1111&receivedEvents=authorizationSucceeded¤cy=GBP&entityReferences=default&pageSize=10"
},
"next": {
"href": "/paymentQueries/payments?startDate=2026-08-17T21:30:20Z&endDate=2026-08-19T10:50:45.392Z&paymentId=payku6vn11Nz5av_tUPw-GyA0&minAmount=300&maxAmount=650&last4Digits=1111&receivedEvents=authorizationSucceeded¤cy=GBP&entityReferences=default&pageSize=10"
}
},
"_embedded": {
"payments": [
{
"timestamp": "2026-08-19T13:44:43.630Z",
"paymentId": "payxrP-FyWbsg-Xs0QZL9WK-0",
"transactionReference": "07689df2-7e68-4e94-828c-3a43c38fae4c",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "262033"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payxrP-FyWbsg-Xs0QZL9WK-0"
}
}
},
{
"timestamp": "2026-08-19T13:44:40.924Z",
"paymentId": "paydyrGHSMWynO_V0b1ZAKHb0",
"transactionReference": "c5180092-fa58-4771-9770-108aafadd6ac",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "922641"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paydyrGHSMWynO_V0b1ZAKHb0"
}
}
},
{
"timestamp": "2026-08-19T13:44:38.161Z",
"paymentId": "paygSAoftgF_bjP7FCUCbhRQ0",
"transactionReference": "6cc5d236-116c-4132-a075-41aaa0fdd8c8",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "305730"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paygSAoftgF_bjP7FCUCbhRQ0"
}
}
},
{
"timestamp": "2026-08-19T13:44:36.934Z",
"paymentId": "payiMoeQ5me59ykcLi4Op14m0",
"transactionReference": "58ded0e2-bc44-4ae9-8cb1-e00d9b7386f9",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "793150"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payiMoeQ5me59ykcLi4Op14m0"
}
}
},
{
"timestamp": "2026-08-19T13:44:33.209Z",
"paymentId": "paye_Xb84SCoQVodEMOLQEs10",
"transactionReference": "e9b50c9a-ae4e-4afb-ab8a-721af781bf05",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "393558"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paye_Xb84SCoQVodEMOLQEs10"
}
}
},
{
"timestamp": "2026-08-19T13:44:31.966Z",
"paymentId": "paynRxC16ALQ7UiCKWGaJGSf0",
"transactionReference": "09dc405c-7d5e-4176-a2f1-43f387bd3744",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "701855"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paynRxC16ALQ7UiCKWGaJGSf0"
}
}
},
{
"timestamp": "2026-08-19T13:44:29.996Z",
"paymentId": "payGlJwNBPaqGtGva7CCzhb40",
"transactionReference": "b199db6b-adf8-4d48-ba87-2b3aff95760e",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "500160"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payGlJwNBPaqGtGva7CCzhb40"
}
}
},
{
"timestamp": "2026-08-19T13:44:28.005Z",
"paymentId": "payiD5ku26v8X1QE454fQc250",
"transactionReference": "6855dd44-743f-4cbc-aebc-804f3cb3cd8a",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "962017"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payiD5ku26v8X1QE454fQc250"
}
}
},
{
"timestamp": "2026-08-19T13:44:26.328Z",
"paymentId": "pay4Vx0Ft1OYWtXq-43OrZdy0",
"transactionReference": "1b5a7757-1a32-441a-b06c-18574eee4014",
"transactionType": "recurring",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "406747"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "4444**"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/pay4Vx0Ft1OYWtXq-43OrZdy0"
}
}
},
{
"timestamp": "2026-08-19T10:50:45.392Z",
"paymentId": "payku6vn11Nz5av_tUPw-GyA0",
"transactionReference": "7ac302fb-0015-4b61-bf29-ea9f4da11fa1",
"orderReference": "order-12345",
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"issuer": {
"authorizationCode": "688727"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payku6vn11Nz5av_tUPw-GyA0"
}
}
}
]
}
}
},
"Query payments by transactionReference": {
"description": "Query payments using a transactionReference",
"value": {
"_links": {
"self": {
"href": "/paymentQueries/payments?transactionReference=6cc5d236-116c-4132-a075-41aaa0fdd8c8"
}
},
"_embedded": {
"payments": [
{
"timestamp": "2026-08-19T13:44:38.161Z",
"paymentId": "paygSAoftgF_bjP7FCUCbhRQ0",
"transactionReference": "6cc5d236-116c-4132-a075-41aaa0fdd8c8",
"orderReference": "order-12345",
"narrative": {
"line1": "Test1"
},
"transactionType": "oneTime",
"authorizationType": "authorization",
"lastEvent": "authorizationSucceeded",
"entity": "default",
"issuer": {
"authorizationCode": "305730"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paygSAoftgF_bjP7FCUCbhRQ0"
}
}
}
]
}
}
},
"Query payments by transactionReference (with fpanLastFour & token info)": {
"description": "Query payments using a transactionReference. We return the `fpanLastFour` for a mobile wallet payment.",
"value": {
"_links": {
"self": {
"href": "/paymentQueries/payments?transactionReference=674c5d236-216c-4132-a175-41aaa0fdd8c8"
}
},
"_embedded": {
"payments": [
{
"timestamp": "2026-08-19T14:46:34.621Z",
"paymentId": "payaoWxC_FmqgAWCCkoagD8M0",
"transactionReference": "674c5d236-216c-4132-a175-41aaa0fdd8c8",
"narrative": {
"line1": "TEST",
"line2": "TEST2"
},
"transactionType": "oneTime",
"authorizationType": "authorization",
"lastEvent": "authorizationSucceeded",
"entity": "default",
"issuer": {
"authorizationCode": "006328"
},
"scheme": {
"reference": "486231531940490"
},
"token": {
"href": "https://access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoiVkUzN3NHK3U0Rk9KeEJXWTNtazREb3dta2JJYnVFaGxBK3pUMjYxbTNqMD0ifQ",
"tokenId": "9916048554737561004"
},
"paymentInstrument": {
"type": "card/network+masked",
"card": {
"number": {
"last4Digits": "0639",
"cardBin": "475526",
"fpanLastFour": "7512"
},
"brand": "visa",
"expiryDate": {
"month": 6,
"year": 2031
},
"countryCode": "GB",
"fundingType": "credit",
"issuerName": "AN ISSUING BANK PLC",
"paymentAccountReference": "V0010013821161242985250081705",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 100
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payaoWxC_FmqgAWCCkoagD8M0"
}
}
}
]
}
}
},
"Query payments by transactionReference (no results)": {
"description": "Querying a payment by a transactionReference, with no matching results found",
"value": {
"_links": {
"self": {
"href": "/paymentQueries/payments?transactionReference=Memory267"
},
"paymentQueries:queryArchive": {
"href": "/paymentQueries/archivedPayments?Memory267&entityReference=default",
"templated": true
}
},
"_embedded": {
"payments": []
}
}
},
"Query payments by orderReference": {
"description": "Query payments using an orderReference",
"value": {
"_links": {
"self": {
"href": "/paymentQueries/payments?orderReference=order-12345"
}
},
"_embedded": {
"payments": [
{
"timestamp": "2026-08-20T13:47:52.365Z",
"paymentId": "payOoT928hHR9OwZh-iisTuR0",
"transactionReference": "78f1c782-2816-45ca-bb1f-c46e789a9c81",
"orderReference": "order-12345",
"narrative": {
"line1": "Test1"
},
"transactionType": "oneTime",
"authorizationType": "authorization",
"lastEvent": "authorizationRefused",
"entity": "default",
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payOoT928hHR9OwZh-iisTuR0"
}
}
},
{
"timestamp": "2026-08-20T13:44:38.161Z",
"paymentId": "paygSAoftgF_bjP7FCUCbhRQ0",
"transactionReference": "6cc5d236-116c-4132-a075-41aaa0fdd8c8",
"orderReference": "order-12345",
"narrative": {
"line1": "Test1"
},
"transactionType": "oneTime",
"authorizationType": "authorization",
"lastEvent": "authorizationSucceeded",
"entity": "default",
"issuer": {
"authorizationCode": "305730"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paygSAoftgF_bjP7FCUCbhRQ0"
}
}
},
{
"timestamp": "2026-08-20T13:44:36.934Z",
"paymentId": "payiMoeQ5me59ykcLi4Op14m0",
"transactionReference": "58ded0e2-bc44-4ae9-8cb1-e00d9b7386f9",
"orderReference": "order-12345",
"narrative": {
"line1": "Test1"
},
"transactionType": "oneTime",
"authorizationType": "authorization",
"lastEvent": "authorizationSucceeded",
"entity": "default",
"issuer": {
"authorizationCode": "793150"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payiMoeQ5me59ykcLi4Op14m0"
}
}
},
{
"timestamp": "2026-08-20T13:44:33.209Z",
"paymentId": "paye_Xb84SCoQVodEMOLQEs10",
"transactionReference": "e9b50c9a-ae4e-4afb-ab8a-721af781bf05",
"orderReference": "order-12345",
"narrative": {
"line1": "Test1"
},
"transactionType": "oneTime",
"authorizationType": "authorization",
"lastEvent": "authorizationSucceeded",
"entity": "default",
"issuer": {
"authorizationCode": "393558"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paye_Xb84SCoQVodEMOLQEs10"
}
}
},
{
"timestamp": "2026-08-20T13:44:31.966Z",
"paymentId": "paynRxC16ALQ7UiCKWGaJGSf0",
"transactionReference": "09dc405c-7d5e-4176-a2f1-43f387bd3744",
"orderReference": "order-12345",
"narrative": {
"line1": "Test1"
},
"transactionType": "oneTime",
"authorizationType": "authorization",
"lastEvent": "authorizationSucceeded",
"entity": "default",
"issuer": {
"authorizationCode": "701855"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/paynRxC16ALQ7UiCKWGaJGSf0"
}
}
},
{
"timestamp": "2026-08-20T13:44:29.996Z",
"paymentId": "payGlJwNBPaqGtGva7CCzhb40",
"transactionReference": "b199db6b-adf8-4d48-ba87-2b3aff95760e",
"orderReference": "order-12345",
"narrative": {
"line1": "Test1"
},
"transactionType": "oneTime",
"authorizationType": "authorization",
"lastEvent": "authorizationSucceeded",
"entity": "default",
"issuer": {
"authorizationCode": "500160"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payGlJwNBPaqGtGva7CCzhb40"
}
}
},
{
"timestamp": "2026-08-19T10:50:45.392Z",
"paymentId": "payku6vn11Nz5av_tUPw-GyA0",
"transactionReference": "7ac302fb-0015-4b61-bf29-ea9f4da11fa1",
"orderReference": "order-12345",
"narrative": {
"line1": "Test1"
},
"transactionType": "oneTime",
"authorizationType": "authorization",
"lastEvent": "authorizationSucceeded",
"entity": "default",
"issuer": {
"authorizationCode": "688727"
},
"scheme": {
"reference": "060720116005062"
},
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"expiryDate": {
"month": 9,
"year": 2029
},
"fundingType": "credit",
"issuerName": "UNKNOWN",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 650
},
"_links": {
"self": {
"href": "/paymentQueries/payments/payku6vn11Nz5av_tUPw-GyA0"
}
}
}
]
}
}
}
}
}
}
},
"400": {
"description": "Bad request",
"content": {
"application/vnd.worldpay.payment-queries-v1.hal+json": {
"schema": {
"$ref": "#/components/schemas/pq_querybydaterange_400_response"
},
"examples": {
"Invalid parameter (pageSize)": {
"description": "Invalid page size",
"value": {
"errorName": "invalidPageSize",
"message": "Provided page size is not valid."
}
},
"Invalid parameter (Start date too old)": {
"description": "Start date must not be older than one year",
"value": {
"errorName": "startDateTooOld",
"message": "Provided start date must not be older than 1 year."
}
},
"Invalid parameter (last4Digits)": {
"description": "Exactly 4 integers must be provided",
"value": {
"errorName": "invalidLast4Digits",
"message": "Provided last 4 digits are not valid."
}
}
}
}
}
}
}
}
},
"/paymentQueries/payments/{paymentId}": {
"get": {
"summary": "Retrieve a payment",
"description": "Retrieve a single payment by payment ID.\n\nThe API returns detailed data for payments processed after 25 June 2024. For payments processed before then use our [query for historical payments](/products/payment-queries/@v1/query-archive.md).",
"operationId": "retrieveByPaymentId",
"parameters": [
{
"in": "header",
"name": "Accept",
"required": true,
"schema": {
"type": "string",
"example": "application/vnd.worldpay.payment-queries-v1.hal+json"
}
},
{
"name": "paymentId",
"in": "path",
"required": true,
"description": "Unique identifier generated for each payment. Historic `paymentId` values in UUID format.",
"example": "payv0A4Hx2eY1-5P2_CpV7qy0",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Retrieve complete details of a single payment including the event history & next action links.",
"content": {
"application/vnd.worldpay.payment-queries-v1.hal+json": {
"schema": {
"$ref": "#/components/schemas/pq_querybypaymentid_200_response"
},
"examples": {
"Retrieve a payment by paymentId (authorization succeeded)": {
"description": "Retrieve a single payment using the paymentId where the requested authorization succeeded",
"value": {
"timestamp": "2026-08-19T09:11:13.040Z",
"paymentId": "payXh3TDn2VF9CjwJ61KCWjV0",
"transactionReference": "AP-withToken-fpanLastFour-try-01",
"narrative": {
"line1": "TEST",
"line2": "TEST2"
},
"transactionType": "oneTime",
"authorizationType": "authorization",
"lastEvent": "authorizationSucceeded",
"entity": "default",
"issuer": {
"authorizationCode": "250627"
},
"scheme": {
"reference": "060720116005060"
},
"token": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoiTURoWVZBVk1LNk1zWDNIUGYwYU11TExBTkovdTJtVTFRcDkzSlBwTXBEbz0ifQ",
"tokenId": "9916015785857299715"
},
"paymentInstrument": {
"type": "card/network+masked",
"card": {
"number": {
"last4Digits": "0639",
"cardBin": "475526",
"fpanLastFour": "7512"
},
"brand": "visa",
"expiryDate": {
"month": 6,
"year": 2031
},
"countryCode": "GB",
"fundingType": "credit",
"issuerName": "AN ISSUING BANK PLC",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 10
},
"events": [
{
"eventName": "authorizationSucceeded",
"timestamp": "2026-08-19T09:11:14.030Z",
"commandId": "cmdpsUGFY4GtpmInC5_q6nuF0",
"outcome": "authorized"
},
{
"eventName": "authorizationRequested",
"timestamp": "2026-08-19T09:11:13.040Z",
"commandId": "cmdpsUGFY4GtpmInC5_q6nuF0"
}
],
"_links": {
"self": {
"href": "/paymentQueries/payments/payXh3TDn2VF9CjwJ61KCWjV0"
},
"tokens:token": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoiTURoWVZBVk1LNk1zWDNIUGYwYU11TExBTkovdTJtVTFRcDkzSlBwTXBEbz0ifQ"
},
"cardPayments:cancel": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNi4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mF2JAUF9Z3Qc:dcxpju50nwRzxZvOEmdeYlNNLX:9LWFu+88::o0aHeaJsFlbF9V8Sh3D6QRmmQuaVZB0nhIVHuXn:h5Cs01S+RZXDN4j1RY5uGpudSEc:v2txu5nGjVyQp4+gScVEDjnCwAQCsvAxAajAeXibZ0n191VAhCujl7YvzdpXvHVw4vj97vSvml0biEYHoHrVFxlt81J:CeUWqYB5LBSdGaoY9p7oSrItS2+fM8leuOb+c:vuVTMaCTio2UBGa628quxNnS9eMiLTjhnZWNiAj2ugpUlJrH6iLrbka0qngeZC4kcKM31mXDmfMev+6hSvQrN6MzQWl8r0g=="
},
"cardPayments:settle": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/full/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNi4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mF2JAUF9Z3Qc:dcxpju50nwRzxZvOEmdeYlNNLX:9LWFu+88::o0aHeaJsFlbF9V8Sh3D6QRmmQuaVZB0nhIVHuXn:h5Cs01S+RZXDN4j1RY5uGpudSEc:v2txu5nGjVyQp4+gScVEDjnCwAQCsvAxAajAeXibZ0n191VAhCujl7YvzdpXvHVw4vj97vSvml0biEYHoHrVFxlt81J:CeUWqYB5LBSdGaoY9p7oSrItS2+fM8leuOb+c:vuVTMaCTio2UBGa628quxNnS9eMiLTjhnZWNiAj2ugpUlJrH6iLrbka0qngeZC4kcKM31mXDmfMev+6hSvQrN6MzQWl8r0g=="
},
"cardPayments:partialSettle": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/partials/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNi4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mF2JAUF9Z3Qc:dcxpju50nwRzxZvOEmdeYlNNLX:9LWFu+88::o0aHeaJsFlbF9V8Sh3D6QRmmQuaVZB0nhIVHuXn:h5Cs01S+RZXDN4j1RY5uGpudSEc:v2txu5nGjVyQp4+gScVEDjnCwAQCsvAxAajAeXibZ0n191VAhCujl7YvzdpXvHVw4vj97vSvml0biEYHoHrVFxlt81J:CeUWqYB5LBSdGaoY9p7oSrItS2+fM8leuOb+c:vuVTMaCTio2UBGa628quxNnS9eMiLTjhnZWNiAj2ugpUlJrH6iLrbka0qngeZC4kcKM31mXDmfMev+6hSvQrN6MzQWl8r0g=="
},
"cardPayments:events": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/events/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNi4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mF2JAUF9Z3Qc:dcxpju50nwRzxZvOEmdeYlNNLX:9LWFu+88::o0aHeaJsFlbF9V8Sh3D6QRmmQuaVZB0nhIVHuXn:h5Cs01S+RZXDN4j1RY5uGpudSEc:v2txu5nGjVyQp4+gScVEDjnCwAQCsvAxAajAeXibZ0n191VAhCujl7YvzdpXvHVw4vj97vSvml0biEYHoHrVFxlt81J:CeUWqYB5LBSdGaoY9p7oSrItS2+fM8leuOb+c:vuVTMaCTio2UBGa628quxNnS9eMiLTjhnZWNiAj2ugpUlJrH6iLrbka0qngeZC4kcKM31mXDmfMev+6hSvQrN6MzQWl8r0g=="
},
"cardPayments:partialCancel": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/cancellations/partials/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNi4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mF2JAUF9Z3Qc:dcxpju50nwRzxZvOEmdeYlNNLX:9LWFu+88::o0aHeaJsFlbF9V8Sh3D6QRmmQuaVZB0nhIVHuXn:h5Cs01S+RZXDN4j1RY5uGpudSEc:v2txu5nGjVyQp4+gScVEDjnCwAQCsvAxAajAeXibZ0n191VAhCujl7YvzdpXvHVw4vj97vSvml0biEYHoHrVFxlt81J:CeUWqYB5LBSdGaoY9p7oSrItS2+fM8leuOb+c:vuVTMaCTio2UBGa628quxNnS9eMiLTjhnZWNiAj2ugpUlJrH6iLrbka0qngeZC4kcKM31mXDmfMev+6hSvQrN6MzQWl8r0g=="
},
"cardPayments:reverse": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/reversals/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNi4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mF2JAUF9Z3Qc:dcxpju50nwRzxZvOEmdeYlNNLX:9LWFu+88::o0aHeaJsFlbF9V8Sh3D6QRmmQuaVZB0nhIVHuXn:h5Cs01S+RZXDN4j1RY5uGpudSEc:v2txu5nGjVyQp4+gScVEDjnCwAQCsvAxAajAeXibZ0n191VAhCujl7YvzdpXvHVw4vj97vSvml0biEYHoHrVFxlt81J:CeUWqYB5LBSdGaoY9p7oSrItS2+fM8leuOb+c:vuVTMaCTio2UBGa628quxNnS9eMiLTjhnZWNiAj2ugpUlJrH6iLrbka0qngeZC4kcKM31mXDmfMev+6hSvQrN6MzQWl8r0g=="
}
}
}
},
"Retrieve a payment by paymentId (authorization refused)": {
"description": "Retrieve a single payment using the paymentId where the requested authorization was refused by the issuer",
"value": {
"timestamp": "2025-06-08T16:19:24.365Z",
"paymentId": "payBnu__aoOVW2p4D2ztI0NM0",
"transactionReference": "db38791b-7735-449a-b118-16b2419926ab",
"narrative": {
"line1": "trading name"
},
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"lastEvent": "authorizationRefused",
"paymentInstrument": {
"type": "card/plain+masked",
"card": {
"number": {
"last4Digits": "1111",
"cardBin": "444433"
},
"brand": "visa",
"fundingType": "credit",
"issuerName": "UNKNOWN",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 1200
},
"events": [
{
"eventName": "authorizationRequested",
"timestamp": "2025-06-08T16:19:24.365Z",
"commandId": "cmdafuBGvEdr9v-19D7aTn490"
},
{
"eventName": "authorizationRefused",
"timestamp": "2025-06-08T16:19:24.801Z",
"description": "Do not honour",
"code": "5",
"outcome": "refused",
"commandId": "cmdafuBGvEdr9v-19D7aTn490"
}
],
"_links": {
"self": {
"href": "/paymentQueries/payments/payBnu__aoOVW2p4D2ztI0NM0"
}
}
}
},
"Retrieve a payment by paymentId (authorization failed)": {
"description": "Retrieve a single payment using the paymentId where the requested authorization failed",
"value": {
"timestamp": "2025-06-08T16:06:03.266Z",
"paymentId": "payT2xg9cnwFBSwCNGmi-r3b0",
"transactionReference": "45297dcb-344a-123e-2914-9243fbde55fa",
"narrative": {
"line1": "trading name"
},
"transactionType": "oneTime",
"authorizationType": "authorization",
"entity": "default",
"lastEvent": "authorizationFailed",
"paymentInstrument": {
"type": "card/plain"
},
"value": {
"currency": "GBP",
"amount": 10
},
"events": [
{
"eventName": "authorizationRequested",
"timestamp": "2025-06-08T16:06:03.266Z",
"commandId": "cmdIw257vWpg0cwky1c34r600"
},
{
"eventName": "authorizationFailed",
"timestamp": "2025-06-08T16:06:03.398Z",
"error": {
"name": "internalErrorOccurred",
"message": "Bad request reported downstream"
},
"commandId": "cmdIw257vWpg0cwky1c34r600"
}
],
"_links": {
"self": {
"href": "/paymentQueries/payments/payT2xg9cnwFBSwCNGmi-r3b0"
}
}
}
},
"Retrieve a payment by paymentId (authorization requested)": {
"description": "Retrieve a single payment using the paymentId where an authorization was requested, but no outcome has yet been received",
"value": {
"timestamp": "2025-07-07T11:07:38.731Z",
"paymentId": "paycGeAtsYssrrtgieKBA3Pi0",
"transactionReference": "428c0aed-230c-46cc-9897-b6f935378078",
"narrative": {
"line1": "trading name"
},
"transactionType": "cardOnFile",
"authorizationType": "authorization",
"entity": "default",
"lastEvent": "authorizationRequested",
"paymentInstrument": {
"type": "card/plain"
},
"value": {
"currency": "GBP",
"amount": 250
},
"events": [
{
"eventName": "authorizationRequested",
"timestamp": "2025-07-07T11:07:38.731Z",
"commandId": "cmdaa0-Fc4dfv8jQvtRK13Bz0"
}
],
"_links": {
"self": {
"href": "/paymentQueries/payments/paycGeAtsYssrrtgieKBA3Pi0"
}
}
}
},
"Retrieve a payment by paymentId (authorization succeeded, settled, refunded)": {
"description": "Retrieve a single payment using the paymentId where the requested authorization succeeded and was subsequently settled and refunded",
"value": {
"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",
"entity": "default",
"lastEvent": "refundRequestSubmitted",
"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",
"commandId": "cmd0ar7Y26_d-vXkf8Rm02xT0"
},
{
"eventName": "authorizationSucceeded",
"timestamp": "2025-06-08T16:11:14.229Z",
"outcome": "authorized",
"commandId": "cmd0ar7Y26_d-vXkf8Rm02xT0"
},
{
"eventName": "settlementRequested",
"timestamp": "2025-06-09T08:14:23.138Z",
"type": "partialSettlement",
"settlementReference": "mySettleRef",
"value": {
"currency": "GBP",
"amount": 1000
},
"commandId": "cmdA1d-R3sO72_Xkf8R103Ni0"
},
{
"eventName": "settlementRequestSubmitted",
"timestamp": "2025-06-09T08:14:23.224Z",
"commandId": "cmdA1d-R3sO72_Xkf8R103Ni0"
},
{
"eventName": "refundRequested",
"timestamp": "2025-07-01T09:14:28.009Z",
"type": "partialRefund",
"refundReference": "myRefundRef",
"value": {
"currency": "GBP",
"amount": 1000
},
"commandId": "cmdB2-xT9aS05DvGfa_1Grtc0"
},
{
"eventName": "refundRequestSubmitted",
"timestamp": "2025-07-01T09:14:28.151Z",
"commandId": "cmdB2-xT9aS05DvGfa_1Grtc0"
}
],
"_links": {
"self": {
"href": "/paymentQueries/payments/payVGX28GOT7iDY5qanttPWF0"
},
"cardPayments:events": {
"href": "https://access.worldpay-bsh.securedataplatform.co.uk/payments/events/{linkData}"
},
"cardPayments:partialRefund": {
"href": "https://access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/refunds/partials/{linkData}"
}
}
}
},
"Retrieve a payment by paymentId (authorization succeeded, incremental authorization succeeded)": {
"description": "Retrieve a single payment using the paymentId where the requested authorization succeeded and the authorized amount was subsequently increased",
"value": {
"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",
"entity": "default",
"lastEvent": "refundRequestSubmitted",
"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",
"commandId": "cmd0ar7Y26_d-vXkf8Rm02xT0"
},
{
"eventName": "authorizationSucceeded",
"timestamp": "2025-06-08T16:11:14.229Z",
"outcome": "authorized",
"commandId": "cmd0ar7Y26_d-vXkf8Rm02xT0"
},
{
"eventName": "incrementalAuthorizationRequested",
"timestamp": "2025-06-08T17:11:13.164Z",
"commandId": "cmd0ar7Y26_d-vXkf8Rm02xU0",
"type": "incrementalAuthorization",
"value": {
"currency": "GBP",
"amount": 120
}
},
{
"eventName": "incrementalAuthorizationSucceeded",
"timestamp": "2025-06-08T17:11:14.229Z",
"outcome": "authorized",
"commandId": "cmd0ar7Y26_d-vXkf8Rm02xT0"
},
{
"eventName": "settlementRequested",
"timestamp": "2025-06-09T08:14:23.138Z",
"type": "partialSettlement",
"settlementReference": "mySettleRef",
"value": {
"currency": "GBP",
"amount": 1000
},
"commandId": "cmdA1d-R3sO72_Xkf8R103Ni0"
},
{
"eventName": "settlementRequestSubmitted",
"timestamp": "2025-06-09T08:14:23.224Z",
"commandId": "cmdA1d-R3sO72_Xkf8R103Ni0"
},
{
"eventName": "refundRequested",
"timestamp": "2025-07-01T09:14:28.009Z",
"type": "partialRefund",
"refundReference": "myRefundRef",
"value": {
"currency": "GBP",
"amount": 1000
},
"commandId": "cmdB2-xT9aS05DvGfa_1Grtc0"
},
{
"eventName": "refundRequestSubmitted",
"timestamp": "2025-07-01T09:14:28.151Z",
"commandId": "cmdB2-xT9aS05DvGfa_1Grtc0"
}
],
"_links": {
"self": {
"href": "/paymentQueries/payments/payVGX28GOT7iDY5qanttPWF0"
},
"cardPayments:events": {
"href": "https://access.worldpay-bsh.securedataplatform.co.uk/payments/events/{linkData}"
},
"cardPayments:partialRefund": {
"href": "https://access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/refunds/partials/{linkData}"
}
}
}
},
"Retrieve a payment by paymentId (mobile wallet transaction with fpanLastFour)": {
"description": "Retrieve a single payment using the paymentId where the payment instrument was a mobile wallet, and the `fpanLastFour` is returned",
"value": {
"timestamp": "2026-08-19T09:11:13.040Z",
"paymentId": "payXh3TDn2VF9CjwJ61KCWjV0",
"transactionReference": "AP-withToken-fpanLastFour-try-01",
"narrative": {
"line1": "TEST",
"line2": "TEST2"
},
"transactionType": "oneTime",
"authorizationType": "authorization",
"lastEvent": "authorizationSucceeded",
"entity": "default",
"issuer": {
"authorizationCode": "250627"
},
"scheme": {
"reference": "060720116005060"
},
"token": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoiTURoWVZBVk1LNk1zWDNIUGYwYU11TExBTkovdTJtVTFRcDkzSlBwTXBEbz0ifQ",
"tokenId": "9916015785857299715"
},
"paymentInstrument": {
"type": "card/network+masked",
"card": {
"number": {
"last4Digits": "0639",
"cardBin": "475526",
"fpanLastFour": "7512"
},
"brand": "visa",
"expiryDate": {
"month": 6,
"year": 2031
},
"countryCode": "GB",
"fundingType": "credit",
"issuerName": "AN ISSUING BANK PLC",
"paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E",
"category": "consumer"
}
},
"value": {
"currency": "GBP",
"amount": 10
},
"events": [
{
"eventName": "authorizationSucceeded",
"timestamp": "2026-08-19T09:11:14.030Z",
"commandId": "cmdpsUGFY4GtpmInC5_q6nuF0",
"outcome": "authorized"
},
{
"eventName": "authorizationRequested",
"timestamp": "2026-08-19T09:11:13.040Z",
"commandId": "cmdpsUGFY4GtpmInC5_q6nuF0"
}
],
"_links": {
"self": {
"href": "/paymentQueries/payments/payXh3TDn2VF9CjwJ61KCWjV0"
},
"tokens:token": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoiTURoWVZBVk1LNk1zWDNIUGYwYU11TExBTkovdTJtVTFRcDkzSlBwTXBEbz0ifQ"
},
"cardPayments:cancel": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNi4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mF2JAUF9Z3Qc:dcxpju50nwRzxZvOEmdeYlNNLX:9LWFu+88::o0aHeaJsFlbF9V8Sh3D6QRmmQuaVZB0nhIVHuXn:h5Cs01S+RZXDN4j1RY5uGpudSEc:v2txu5nGjVyQp4+gScVEDjnCwAQCsvAxAajAeXibZ0n191VAhCujl7YvzdpXvHVw4vj97vSvml0biEYHoHrVFxlt81J:CeUWqYB5LBSdGaoY9p7oSrItS2+fM8leuOb+c:vuVTMaCTio2UBGa628quxNnS9eMiLTjhnZWNiAj2ugpUlJrH6iLrbka0qngeZC4kcKM31mXDmfMev+6hSvQrN6MzQWl8r0g=="
},
"cardPayments:settle": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/full/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNi4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mF2JAUF9Z3Qc:dcxpju50nwRzxZvOEmdeYlNNLX:9LWFu+88::o0aHeaJsFlbF9V8Sh3D6QRmmQuaVZB0nhIVHuXn:h5Cs01S+RZXDN4j1RY5uGpudSEc:v2txu5nGjVyQp4+gScVEDjnCwAQCsvAxAajAeXibZ0n191VAhCujl7YvzdpXvHVw4vj97vSvml0biEYHoHrVFxlt81J:CeUWqYB5LBSdGaoY9p7oSrItS2+fM8leuOb+c:vuVTMaCTio2UBGa628quxNnS9eMiLTjhnZWNiAj2ugpUlJrH6iLrbka0qngeZC4kcKM31mXDmfMev+6hSvQrN6MzQWl8r0g=="
},
"cardPayments:partialSettle": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/partials/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNi4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mF2JAUF9Z3Qc:dcxpju50nwRzxZvOEmdeYlNNLX:9LWFu+88::o0aHeaJsFlbF9V8Sh3D6QRmmQuaVZB0nhIVHuXn:h5Cs01S+RZXDN4j1RY5uGpudSEc:v2txu5nGjVyQp4+gScVEDjnCwAQCsvAxAajAeXibZ0n191VAhCujl7YvzdpXvHVw4vj97vSvml0biEYHoHrVFxlt81J:CeUWqYB5LBSdGaoY9p7oSrItS2+fM8leuOb+c:vuVTMaCTio2UBGa628quxNnS9eMiLTjhnZWNiAj2ugpUlJrH6iLrbka0qngeZC4kcKM31mXDmfMev+6hSvQrN6MzQWl8r0g=="
},
"cardPayments:events": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/events/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNi4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mF2JAUF9Z3Qc:dcxpju50nwRzxZvOEmdeYlNNLX:9LWFu+88::o0aHeaJsFlbF9V8Sh3D6QRmmQuaVZB0nhIVHuXn:h5Cs01S+RZXDN4j1RY5uGpudSEc:v2txu5nGjVyQp4+gScVEDjnCwAQCsvAxAajAeXibZ0n191VAhCujl7YvzdpXvHVw4vj97vSvml0biEYHoHrVFxlt81J:CeUWqYB5LBSdGaoY9p7oSrItS2+fM8leuOb+c:vuVTMaCTio2UBGa628quxNnS9eMiLTjhnZWNiAj2ugpUlJrH6iLrbka0qngeZC4kcKM31mXDmfMev+6hSvQrN6MzQWl8r0g=="
},
"cardPayments:partialCancel": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/cancellations/partials/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNi4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mF2JAUF9Z3Qc:dcxpju50nwRzxZvOEmdeYlNNLX:9LWFu+88::o0aHeaJsFlbF9V8Sh3D6QRmmQuaVZB0nhIVHuXn:h5Cs01S+RZXDN4j1RY5uGpudSEc:v2txu5nGjVyQp4+gScVEDjnCwAQCsvAxAajAeXibZ0n191VAhCujl7YvzdpXvHVw4vj97vSvml0biEYHoHrVFxlt81J:CeUWqYB5LBSdGaoY9p7oSrItS2+fM8leuOb+c:vuVTMaCTio2UBGa628quxNnS9eMiLTjhnZWNiAj2ugpUlJrH6iLrbka0qngeZC4kcKM31mXDmfMev+6hSvQrN6MzQWl8r0g=="
},
"cardPayments:reverse": {
"href": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/reversals/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJzaW9uIjoiNi4wLjAifQ==.sN:g8wd64bwkbrp0md+bPxcanBnk2zLdsIqSa1pR99GeDrCwEtsymFb5gQw9WlrStDTK3eIWPy93y:7njc4649JSrU7+vFDl1J36+cwOkX0lW4Z+fnZKMutoUGX3m1:mF2JAUF9Z3Qc:dcxpju50nwRzxZvOEmdeYlNNLX:9LWFu+88::o0aHeaJsFlbF9V8Sh3D6QRmmQuaVZB0nhIVHuXn:h5Cs01S+RZXDN4j1RY5uGpudSEc:v2txu5nGjVyQp4+gScVEDjnCwAQCsvAxAajAeXibZ0n191VAhCujl7YvzdpXvHVw4vj97vSvml0biEYHoHrVFxlt81J:CeUWqYB5LBSdGaoY9p7oSrItS2+fM8leuOb+c:vuVTMaCTio2UBGa628quxNnS9eMiLTjhnZWNiAj2ugpUlJrH6iLrbka0qngeZC4kcKM31mXDmfMev+6hSvQrN6MzQWl8r0g=="
}
}
}
}
}
}
}
},
"404": {
"description": "The payment was not found.",
"content": {
"application/vnd.worldpay.payment-queries-v1.hal+json": {
"schema": {
"$ref": "#/components/schemas/pq_querybypaymentid_404_response"
},
"examples": {
"paymentId not found": {
"description": "The payment was not found.",
"value": {
"errorName": "paymentNotFound",
"message": "The payment you are trying to access does not exist."
}
}
}
}
}
}
}
}
},
"/paymentQueries/archivedPayments": {
"get": {
"summary": "Query historical payments",
"description": "Query payments processed before 25 June 2024.\n\nProvide a `transactionReference` and `entityReference` for a payment to find the matching payment in the archive.",
"operationId": "queryArchivedPayments",
"parameters": [
{
"in": "header",
"name": "Accept",
"required": true,
"schema": {
"type": "string",
"example": "application/vnd.worldpay.payment-queries-v1.hal+json"
}
},
{
"name": "transactionReference",
"in": "query",
"description": "A unique reference generated by you, used to identify a payment throughout its lifecycle.",
"required": true,
"schema": {
"type": "string",
"example": "89197aeb-c94a-456e-8014-1272fbcb64eb"
}
},
{
"name": "entityReference",
"in": "query",
"description": "A merchant entity.",
"required": true,
"schema": {
"type": "string",
"example": "default"
}
}
],
"responses": {
"200": {
"description": "Summary information of a payment.",
"content": {
"application/vnd.worldpay.payment-queries-v1.hal+json": {
"schema": {
"$ref": "#/components/schemas/pq_queryhistoricalpayments_200_response"
},
"examples": {
"Query historical payments": {
"description": "Query historical payments with a transactionReference & entityReference",
"value": {
"_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.co.uk/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.co.uk/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.co.uk/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=default&transactionReference=Test123"
}
}
}
}
}
}
}
},
"400": {
"description": "Bad request",
"content": {
"application/vnd.worldpay.payment-queries-v1.hal+json": {
"schema": {
"$ref": "#/components/schemas/pq_queryhistoricalpayments_400_response"
},
"examples": {
"Entity not configured": {
"description": "Entity not configured",
"value": {
"errorName": "entityIsNotConfigured",
"message": "Entity is not configured to use this resource"
}
}
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"selfLinkOnly": {
"required": [
"self"
],
"type": "object",
"properties": {
"self": {
"type": "object",
"description": "Self link to the page.",
"properties": {
"href": {
"type": "string",
"description": "Self link to the page."
}
}
}
}
},
"authorizationSucceededLinks": {
"required": [
"self"
],
"type": "object",
"properties": {
"self": {
"type": "object",
"description": "Self link to the page.",
"properties": {
"href": {
"type": "string",
"description": "Self link to the page."
},
"cardPayments:cancel": {
"type": "object",
"description": "An action link to cancel the full authorized amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:cancel`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to cancel the full authorized amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/cancellations/{linkData}"
}
}
},
"cardPayments:partialCancel": {
"type": "object",
"description": "An action link to cancel a portion of the authorized amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:partialCancel`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to cancel a portion of the authorized amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/cancellations/partials/{linkData}"
}
}
},
"cardPayments:settle": {
"type": "object",
"description": "An action link to send the full authorized amount for settlement.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:settle`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to send the full authorized amount for settlement.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/full/{linkData}"
}
}
},
"cardPayments:partialSettle": {
"type": "object",
"description": "An action link to send a portion of the authorized amount for settlement.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:partialSettle`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to send a portion of the authorized amount for settlement.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/partials/{linkData}"
}
}
},
"cardPayments:reverse": {
"type": "object",
"description": "An action link to cancel or refund the full amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:reverse`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to cancel or refund the full amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/reversals/{linkData}"
}
}
},
"cardPayments:events": {
"type": "object",
"description": "An action link to retrieve the last event of the payment.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:events`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to retrieve the last event of the payment.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/events/{linkData}"
}
}
}
}
}
}
},
"increaseAuthorizedAmountLinks": {
"required": [
"self"
],
"type": "object",
"properties": {
"self": {
"type": "object",
"description": "Self link to the page.",
"properties": {
"href": {
"type": "string",
"description": "Self link to the page."
},
"cardPayments:increaseAuthorizedAmount": {
"type": "object",
"description": "An action link to increase the authorized amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:increaseAuthorizedAmount`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to increase the authorized amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/incrementalAuthorizations/{linkData}"
}
}
},
"cardPayments:cancel": {
"type": "object",
"description": "An action link to cancel the full authorized amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:cancel`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to cancel the full authorized amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/cancellations/{linkData}"
}
}
},
"cardPayments:partialCancel": {
"type": "object",
"description": "An action link to cancel a portion of the authorized amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:partialCancel`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to cancel a portion of the authorized amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/cancellations/partials/{linkData}"
}
}
},
"cardPayments:settle": {
"type": "object",
"description": "An action link to send the full authorized amount for settlement.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:settle`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to send the full authorized amount for settlement.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/full/{linkData}"
}
}
},
"cardPayments:partialSettle": {
"type": "object",
"description": "An action link to send a portion of the authorized amount for settlement.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:partialSettle`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to send a portion of the authorized amount for settlement.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/partials/{linkData}"
}
}
},
"cardPayments:events": {
"type": "object",
"description": "An action link to retrieve the last event of the payment.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:events`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to retrieve the last event of the payment.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/events/{linkData}"
}
}
}
}
}
}
},
"sentForSettlementLinks": {
"required": [
"self"
],
"type": "object",
"properties": {
"self": {
"type": "object",
"description": "Self link to the page.",
"properties": {
"href": {
"type": "string",
"description": "Self link to the page."
},
"cardPayments:refund": {
"type": "object",
"description": "An action link to refund the full settled amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:refund`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to refund the full settled amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/refunds/full/{linkData}"
}
}
},
"cardPayments:partialRefund": {
"type": "object",
"description": "An action link to refund a portion of the settled amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:partialRefund`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to refund a portion of the settled amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/refunds/partials/{linkData}"
}
}
},
"cardPayments:reverse": {
"type": "object",
"description": "An action link to cancel or refund the full amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:reverse`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to cancel or refund the full amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/sales/reversals/{linkData}"
}
}
},
"cardPayments:events": {
"type": "object",
"description": "An action link to retrieve the last event of the payment.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:events`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to retrieve the last event of the payment.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/events/{linkData}"
}
}
}
}
}
}
},
"partialSettleLinks": {
"required": [
"self"
],
"type": "object",
"properties": {
"self": {
"type": "object",
"description": "Self link to the page.",
"properties": {
"href": {
"type": "string",
"description": "Self link to the page."
},
"cardPayments:refund": {
"type": "object",
"description": "An action link to refund the full settled amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:refund`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to refund the full settled amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/refunds/full/{linkData}"
}
}
},
"cardPayments:partialRefund": {
"type": "object",
"description": "An action link to refund a portion of the settled amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:partialRefund`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to refund a portion of the settled amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/refunds/partials/{linkData}"
}
}
},
"cardPayments:partialSettle": {
"type": "object",
"description": "An action link to send a portion of the authorized amount for settlement.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:partialSettle`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to send a portion of the authorized amount for settlement.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/partials/{linkData}"
}
}
},
"cardPayments:cancel": {
"type": "object",
"description": "An action link to cancel the full authorized amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:cancel`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to cancel the full authorized amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/cancellations/{linkData}"
}
}
},
"cardPayments:reverse": {
"type": "object",
"description": "An action link to cancel or refund the full amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:reverse`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to cancel or refund the full amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/sales/reversals/{linkData}"
}
}
},
"cardPayments:events": {
"type": "object",
"description": "An action link to retrieve the last event of the payment.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:events`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to retrieve the last event of the payment.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/events/{linkData}"
}
}
}
}
}
}
},
"fullSettleLinks": {
"required": [
"self"
],
"type": "object",
"properties": {
"self": {
"type": "object",
"description": "Self link to the page.",
"properties": {
"href": {
"type": "string",
"description": "Self link to the page."
},
"cardPayments:refund": {
"type": "object",
"description": "An action link to refund the full settled amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:refund`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to refund the full settled amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/refunds/full/{linkData}"
}
}
},
"cardPayments:partialRefund": {
"type": "object",
"description": "An action link to refund a portion of the settled amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:partialRefund`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to refund a portion of the settled amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/refunds/partials/{linkData}"
}
}
},
"cardPayments:reverse": {
"type": "object",
"description": "An action link to cancel or refund the full amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:reverse`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to cancel or refund the full amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/sales/reversals/{linkData}"
}
}
},
"cardPayments:events": {
"type": "object",
"description": "An action link to retrieve the last event of the payment.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:events`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to retrieve the last event of the payment.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/events/{linkData}"
}
}
}
}
}
}
},
"partialRefundLinks": {
"required": [
"self"
],
"type": "object",
"properties": {
"self": {
"type": "object",
"description": "Self link to the page.",
"properties": {
"href": {
"type": "string",
"description": "Self link to the page."
},
"cardPayments:partialRefund": {
"type": "object",
"description": "An action link to refund a portion of the settled amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:partialRefund`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to refund a portion of the settled amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/refunds/partials/{linkData}"
}
}
},
"cardPayments:events": {
"type": "object",
"description": "An action link to retrieve the last event of the payment.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:events`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to retrieve the last event of the payment.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/events/{linkData}"
}
}
}
}
}
}
},
"fullRefundLinks": {
"required": [
"self"
],
"type": "object",
"properties": {
"self": {
"type": "object",
"description": "Self link to the page.",
"properties": {
"href": {
"type": "string",
"description": "Self link to the page."
},
"cardPayments:events": {
"type": "object",
"description": "An action link to retrieve the last event of the payment.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:events`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to retrieve the last event of the payment.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/events/{linkData}"
}
}
}
}
}
}
},
"partialCancelLinks": {
"required": [
"self"
],
"type": "object",
"properties": {
"self": {
"type": "object",
"description": "Self link to the page.",
"properties": {
"href": {
"type": "string",
"description": "Self link to the page."
},
"cardPayments:cancel": {
"type": "object",
"description": "An action link to cancel the full authorized amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:cancel`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to cancel the full authorized amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/cancellations/{linkData}"
}
}
},
"cardPayments:partialCancel": {
"type": "object",
"description": "An action link to cancel a portion of the authorized amount.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:partialCancel`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to cancel a portion of the authorized amount.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/authorizations/cancellations/partials/{linkData}"
}
}
},
"cardPayments:settle": {
"type": "object",
"description": "An action link to send the full authorized amount for settlement.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:settle`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to send the full authorized amount for settlement.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/full/{linkData}"
}
}
},
"cardPayments:partialSettle": {
"type": "object",
"description": "An action link to send a portion of the authorized amount for settlement.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:partialSettle`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to send a portion of the authorized amount for settlement.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/settlements/partials/{linkData}"
}
}
},
"cardPayments:events": {
"type": "object",
"description": "An action link to retrieve the last event of the payment.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:events`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to retrieve the last event of the payment.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/events/{linkData}"
}
}
}
}
}
}
},
"fullCancelLinks": {
"required": [
"self"
],
"type": "object",
"properties": {
"self": {
"type": "object",
"description": "Self link to the page.",
"properties": {
"href": {
"type": "string",
"description": "Self link to the page."
},
"cardPayments:events": {
"type": "object",
"description": "An action link to retrieve the last event of the payment.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:events`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to retrieve the last event of the payment.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/events/{linkData}"
}
}
}
}
}
}
},
"reversalLinks": {
"required": [
"self"
],
"type": "object",
"properties": {
"self": {
"type": "object",
"description": "Self link to the page.",
"properties": {
"href": {
"type": "string",
"description": "Self link to the page."
},
"cardPayments:events": {
"type": "object",
"description": "An action link to retrieve the last event of the payment.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:events`.",
"properties": {
"href": {
"type": "string",
"description": "An action link to retrieve the last event of the payment.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/payments/events/{linkData}"
}
}
}
}
}
}
},
"authorizationRequested": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Worldpay has received your authorization request.",
"enum": [
"authorizationRequested"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"authorizationSucceeded": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your authorization request was successfully approved by the card issuer.",
"enum": [
"authorizationSucceeded"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"outcome": {
"type": "string",
"description": "Outcome of the event. For every requested event there can be a successful or refused event outcome.",
"enum": [
"authorized"
]
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"authorizationRefused": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your authorization request was refused by the card issuer.",
"enum": [
"authorizationRefused"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"outcome": {
"type": "string",
"description": "Outcome of the event. For every requested event there can be a successful or refused event outcome.",
"enum": [
"refused"
]
},
"code": {
"type": "string",
"description": "The response code, used to identify the refusal reason.",
"example": "65"
},
"description": {
"type": "string",
"description": "The description of the refusal reason.",
"example": "Authentication Requested"
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"authorizationFailed": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your authorization request failed.",
"enum": [
"authorizationFailed"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"error": {
"type": "object",
"description": "All Failed events return an error object with a name and a message.",
"properties": {
"name": {
"type": "string",
"description": "Example values are,",
"enum": [
"internalErrorOccurred",
"transactionReferenceIsADuplicate",
"transactionHasAlreadyBeenProcessed",
"channelIsNotSupported",
"currencyIsNotSupported",
"paymentInstrumentIsNotSupported",
"fieldHasInvalidValue",
"fieldIsEmpty",
"cardNumberIsNotRecognized",
"underlyingPaymentInstrumentHasExpired",
"entityIsNotConfigured"
]
},
"message": {
"type": "string",
"description": "Example values are,",
"enum": [
"Payment failed to be authorized",
"Token is unrecognized",
"The transaction reference is a duplicate",
"The transaction has already been processed",
"Currency not supported"
]
}
}
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"authorizationTimedOut": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your authorization request timed out.",
"enum": [
"authorizationTimedOut"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"incrementalAuthorizationRequested": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Worldpay has received your increase authorized amount request.",
"enum": [
"incrementalAuthorizationRequested"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"type": {
"type": "string",
"enum": [
"incrementalAuthorization"
]
},
"value": {
"required": [
"amount",
"currency"
],
"type": "object",
"description": "An object that contains the amount and currency requested to increase the authorized amount.",
"properties": {
"amount": {
"type": "integer",
"description": "This is a whole number including the currency exponent (e.g. GBP has an exponent of 2, so for £2.50 supply:`250`)."
},
"currency": {
"type": "string",
"description": "The 3 digit currency code."
}
}
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"incrementalAuthorizationSucceeded": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your increase authorized amount request was successfully approved by the card issuer.",
"enum": [
"incrementalAuthorizationSucceeded"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"outcome": {
"type": "string",
"description": "Outcome of the event. For every requested event there can be a successful or refused event outcome.",
"enum": [
"authorized"
]
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"incrementalAuthorizationRefused": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your increase authorized amount request was refused by the card issuer.",
"enum": [
"incrementalAuthorizationRefused"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"outcome": {
"type": "string",
"description": "Outcome of the event. For every requested event there can be a successful or refused event outcome.",
"enum": [
"refused"
]
},
"code": {
"type": "string",
"description": "The response code, used to identify the refusal reason.",
"example": "65"
},
"description": {
"type": "string",
"description": "The description of the refusal reason.",
"example": "Authentication Requested"
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"incrementalAuthorizationFailed": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your increase authorized amount request failed.",
"enum": [
"incrementalAuthorizationFailed"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"error": {
"type": "object",
"description": "All Failed events return an error object with a name and a message.",
"properties": {
"name": {
"type": "string",
"description": "Example values are,",
"enum": [
"internalErrorOccurred",
"transactionReferenceIsADuplicate",
"transactionHasAlreadyBeenProcessed",
"channelIsNotSupported",
"currencyIsNotSupported",
"paymentInstrumentIsNotSupported",
"fieldHasInvalidValue",
"fieldIsEmpty",
"cardNumberIsNotRecognized",
"underlyingPaymentInstrumentHasExpired",
"entityIsNotConfigured"
]
},
"message": {
"type": "string",
"description": "Example values are,",
"enum": [
"Payment failed to be authorized",
"Token is unrecognized",
"The transaction reference is a duplicate",
"The transaction has already been processed",
"Currency not supported"
]
}
}
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"incrementalAuthorizationTimedOut": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your increase authorized amount request timed out.",
"enum": [
"incrementalAuthorizationTimedOut"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"saleRequested": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Worldpay has received your sale request.",
"enum": [
"saleRequested"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"saleSucceeded": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your authorization request was successfully approved by the card issuer.",
"enum": [
"saleSucceeded"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"outcome": {
"type": "string",
"description": "Outcome of the event. For every requested event there can be a successful or refused event outcome.",
"enum": [
"authorized"
]
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"saleRefused": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your sale request was refused by the card issuer.",
"enum": [
"saleRefused"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"outcome": {
"type": "string",
"description": "Outcome of the event. For every requested event there can be a successful or refused event outcome.",
"enum": [
"refused"
]
},
"code": {
"type": "string",
"description": "The response code, used to identify the refusal reason.",
"example": "65"
},
"description": {
"type": "string",
"description": "The description of the refusal reason.",
"example": "Authentication Requested"
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"saleFailed": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your sale request failed.",
"enum": [
"saleFailed"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"error": {
"type": "object",
"description": "All Failed events return an error object with a name and a message.",
"properties": {
"name": {
"type": "string",
"description": "Example values are,",
"enum": [
"internalErrorOccurred",
"transactionReferenceIsADuplicate",
"transactionHasAlreadyBeenProcessed",
"channelIsNotSupported",
"currencyIsNotSupported",
"paymentInstrumentIsNotSupported",
"fieldHasInvalidValue",
"fieldIsEmpty",
"cardNumberIsNotRecognized",
"underlyingPaymentInstrumentHasExpired",
"entityIsNotConfigured"
]
},
"message": {
"type": "string",
"description": "Example values are,",
"enum": [
"Payment failed to be authorized",
"Token is unrecognized",
"The transaction reference is a duplicate",
"The transaction has already been processed",
"Currency not supported"
]
}
}
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"saleTimedOut": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your sale request timed out.",
"enum": [
"saleTimedOut"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"settlementRequested": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Worldpay has received your settlement request.",
"enum": [
"settlementRequested"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"type": {
"type": "string",
"enum": [
"fullSettlement",
"partialSettlement"
]
},
"settlementReference": {
"type": "string",
"description": "Your settlement reference"
},
"value": {
"required": [
"amount",
"currency"
],
"type": "object",
"description": "An object that contains the amount and currency requested for settlement.",
"properties": {
"amount": {
"type": "integer",
"description": "This is a whole number including the currency exponent (e.g. GBP has an exponent of 2, so for £2.50 supply:`250`)."
},
"currency": {
"type": "string",
"description": "The 3 digit currency code."
}
}
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"settlementRequestSubmitted": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your settlement request was successfully sent for processing.",
"enum": [
"settlementRequestSubmitted"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"settlementRequestSubmissionFailed": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your settlement request failed.",
"enum": [
"settlementRequestSubmissionFailed"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"settlementRequestSubmissionTimedOut": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your settlement request timed out.",
"enum": [
"settlementRequestSubmissionTimedOut"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"refundRequested": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Worldpay has received your refund request.",
"enum": [
"refundRequested"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"type": {
"type": "string",
"enum": [
"fullRefund",
"partialRefund"
]
},
"refundReference": {
"type": "string",
"description": "Your refund reference"
},
"value": {
"required": [
"amount",
"currency"
],
"type": "object",
"description": "An object that contains the amount and currency requested for refund.",
"properties": {
"amount": {
"type": "integer",
"description": "This is a whole number including the currency exponent (e.g. GBP has an exponent of 2, so for £2.50 supply:`250`)."
},
"currency": {
"type": "string",
"description": "The 3 digit currency code."
}
}
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"refundRequestSubmitted": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your refund request was successfully sent for processing.",
"enum": [
"refundRequestSubmitted"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"refundRequestSubmissionFailed": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your refund request failed.",
"enum": [
"refundRequestSubmissionFailed"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"refundRequestSubmissionTimedOut": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your refund request timed out.",
"enum": [
"refundRequestSubmissionTimedOut"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"cancellationRequested": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Worldpay has received your cancellation request.",
"enum": [
"cancellationRequested"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"cancellationRequestSubmitted": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your cancellation request was successfully sent for processing.",
"enum": [
"cancellationRequestSubmitted"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"cancellationRequestSubmissionFailed": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your cancellation request failed.",
"enum": [
"cancellationRequestSubmissionFailed"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"cancellationRequestSubmissionTimedOut": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your cancellation request timed out.",
"enum": [
"cancellationRequestSubmissionTimedOut"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"reversalRequested": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Worldpay has received your reversal request.",
"enum": [
"reversalRequested"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"value": {
"required": [
"amount",
"currency"
],
"type": "object",
"description": "An object that contains the amount and currency requested for reversal.",
"properties": {
"amount": {
"type": "integer",
"description": "This is a whole number including the currency exponent (e.g. GBP has an exponent of 2, so for £2.50 supply:`250`)."
},
"currency": {
"type": "string",
"description": "The 3 digit currency code."
}
}
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"reversalRequestSubmitted": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your reversal request was successfully sent for processing.",
"enum": [
"reversalRequestSubmitted"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"reversalRequestSubmissionFailed": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your reversal request failed.",
"enum": [
"reversalRequestSubmissionFailed"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"reversalRequestSubmissionTimedOut": {
"required": [
"eventName"
],
"type": "object",
"properties": {
"eventName": {
"type": "string",
"description": "Your reversal request timed out.",
"enum": [
"reversalRequestSubmissionTimedOut"
]
},
"timestamp": {
"type": "string",
"description": "The ISO 8601 date-time at which the event was created."
},
"commandId": {
"$ref": "#/components/schemas/commandId"
}
}
},
"paymentId": {
"maxLength": 36,
"minLength": 25,
"pattern": "^[A-Za-z0-9_-]*$",
"type": "string",
"description": "Unique identifier generated by us for a single payment. Generated at authorization, and maintained through successive payment actions.",
"example": "pay4u_lHl2jobU5S1T2pWkq10"
},
"commandId": {
"maxLength": 36,
"minLength": 25,
"pattern": "^[A-Za-z0-9_-]*$",
"type": "string",
"description": "Unique identifier generated by us for a single instance of an interaction (command) with the Worldpay API.",
"example": "cmdRvD-OxCyXgJLQ9_jbqXAC0"
},
"lastEvent": {
"type": "string",
"description": "The last event received for the payment",
"example": "authorizationSucceeded",
"enum": [
"authorizationRequested",
"authorizationSucceeded",
"authorizationRefused",
"authorizationFailed",
"authorizationTimedOut",
"incrementalAuthorizationRequested",
"incrementalAuthorizationSucceeded",
"incrementalAuthorizationRefused",
"incrementalAuthorizationFailed",
"incrementalAuthorizationTimedOut",
"saleRequested",
"saleSucceeded",
"saleRefused",
"saleFailed",
"saleTimedOut",
"settlementRequested",
"settlementRequestSubmitted",
"settlementRequestSubmissionFailed",
"settlementRequestSubmissionTimedOut",
"refundRequested",
"refundRequestSubmitted",
"refundRequestSubmissionFailed",
"refundRequestSubmissionTimedOut",
"cancellationRequested",
"cancellationRequestSubmitted",
"cancellationRequestSubmissionFailed",
"cancellationRequestSubmissionTimedOut",
"reversalRequested",
"reversalRequestSubmitted",
"reversalRequestSubmissionFailed",
"reversalRequestSubmissionTimedOut"
],
"x-enumDescriptions": {
"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.",
"incrementalAuthorizationRequested": "Worldpay has received your increase authorized amount request.",
"incrementalAuthorizationSucceeded": "Your increase authorized amount request was successfully approved by the card issuer.",
"incrementalAuthorizationRefused": "Your increase authorized amount request was refused by the card issuer.",
"incrementalAuthorizationFailed": "Your increase authorized amount request failed.",
"incrementalAuthorizationTimedOut": "Your increase authorized amount 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.",
"settlementRequested": "Worldpay has received your settlement request.",
"settlementRequestSubmitted": "Your settlement request was successfully sent for processing.",
"settlementRequestSubmissionFailed": "Your settlement request failed.",
"settlementRequestSubmissionTimedOut": "Your settlement request timed out.",
"refundRequested": "Worldpay has received your refund request.",
"refundRequestSubmitted": "Your refund request was successfully sent for processing.",
"refundRequestSubmissionFailed": "We failed to process your refund request.",
"refundRequestSubmissionTimedOut": "Your refund request timed out.",
"cancellationRequested": "Worldpay has received your cancellation request.",
"cancellationRequestSubmitted": "Your cancellation request was successfully sent for processing.",
"cancellationRequestSubmissionFailed": "Your cancellation request failed.",
"cancellationRequestSubmissionTimedOut": "Your cancellation request timed out.",
"reversalRequested": "Worldpay has received your reversal request.",
"reversalRequestSubmitted": "Your reversal request was successfully sent for processing.",
"reversalRequestSubmissionFailed": "Your reversal request failed.",
"reversalRequestSubmissionTimedOut": "Your reversal request timed out."
}
},
"pq_querybypaymentid_200_response": {
"type": "object",
"properties": {
"timestamp": {
"type": "string",
"description": "Payment initial authorization time.",
"example": "2024-05-30T09:49:45.962Z"
},
"paymentId": {
"$ref": "#/components/schemas/paymentId"
},
"transactionReference": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$",
"type": "string",
"description": "A unique reference, generated by you, used to identify a payment throughout its lifecycle."
},
"orderReference": {
"maxLength": 64,
"minLength": 1,
"pattern": "^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$",
"type": "string",
"description": "A reference, generated by you, that you can apply to one or more payments according to your business needs. You may reuse the same reference across multiple payments."
},
"narrative": {
"required": [
"line1"
],
"type": "object",
"description": "The text that appears on your customer's statement. Used to identify the merchant.",
"properties": {
"line1": {
"type": "string",
"description": "The first line of the narrative which appears on your customer's statement (24 characters max. If character is not supported it is replaced with a space)."
},
"line2": {
"type": "string",
"description": "Additional details about the payment e.g. order number, telephone number."
}
}
},
"transactionType": {
"enum": [
"oneTime",
"cardOnFile",
"recurring"
],
"type": "string",
"description": "The transaction type of the payment."
},
"authorizationType": {
"enum": [
"authorization",
"sale"
],
"type": "string",
"description": "The authorization type of the payment."
},
"entity": {
"maxLength": 32,
"minLength": 1,
"pattern": "^([A-Za-z0-9]+[A-Za-z0-9 ]*)?$",
"type": "string",
"description": "Merchant entity name.",
"example": "default"
},
"lastEvent": {
"$ref": "#/components/schemas/lastEvent"
},
"scheme": {
"required": [
"reference"
],
"type": "object",
"description": "An object containing information returned by the card scheme.",
"properties": {
"reference": {
"type": "string",
"description": "The reference returned by the scheme for this particular payment authorization.",
"example": "MCCOLXT1C0104 "
}
}
},
"issuer": {
"required": [
"authorizationCode"
],
"type": "object",
"description": "An object containing information returned by the issuer.",
"properties": {
"authorizationCode": {
"pattern": "^[a-zA-Z0-9]+$",
"type": "string",
"description": "A code returned by the card issuer for a successful authorization. Used in reconciliation and dispute management.",
"example": "T31306"
}
}
},
"token": {
"$ref": "#/components/schemas/tokenResponse"
},
"paymentInstrument": {
"$ref": "#/components/schemas/paymentInstrument"
},
"updatedPaymentInstrument": {
"type": "object",
"description": "The payment instrument supplied in the authorization request.",
"properties": {
"type": {
"enum": [
"card/networkToken",
"card/plain+masked"
],
"type": "string",
"description": "The type of payment instrument supplied in the authorization request."
},
"card": {
"type": "object",
"description": "An object that contains information about the card used.",
"properties": {
"number": {
"type": "object",
"description": "An object that contains information about the card number.",
"properties": {
"cardBin": {
"pattern": "^[0-9*]+$",
"type": "string",
"description": "The card BIN (Bank Identification Number) is the first 6 or 8 digits of the card number, and can be used to identify the card issuer, the card brand(s) (eg Visa, Cartes Bancaires), and the country. Card BINs are used to route transactions, check card capabilities, and in fraud assessments.",
"example": "444433"
},
"last4Digits": {
"pattern": "^[0-9*]+$",
"type": "string",
"description": "The last four digits of the card. Some characters may be obfuscated with a `*` if the PAN length is less than 16 characters.",
"example": "1111"
}
}
},
"expiryDate": {
"type": "object",
"description": "The expiry date of the card or network token (where the supplied paymentInstrument was `card/wallet+applepay`, `card/wallet+googlepay`, `card/networkToken`, `card/networkToken+applepay` or `card/networkToken+googlepay`).",
"properties": {
"month": {
"type": "integer"
},
"year": {
"type": "integer"
}
}
},
"fundingType": {
"type": "string",
"description": "How the card is funded.",
"enum": [
"credit",
"debit",
"prepaid",
"chargeCard",
"deferredDebit"
]
},
"brand": {
"type": "string",
"description": "The card brand that the transaction was processed with. Sometimes referred to as the network or scheme.",
"example": "visa"
}
}
},
"accountUpdaterMessage": {
"type": "string",
"description": "Details on the type of payment instrument update.",
"enum": [
"The merchant is not registered in the update program",
"The account number was changed",
"The account was closed",
"The expiry was changed",
"The issuing bank does not participate in the update program",
"Contact the cardholder for updated information",
"No match found",
"No changes found"
],
"x-enumDescriptions": {
"The merchant is not registered in the update program": "Returned for Real Time Account Updater only. Contact Worldpay to enroll in the service.",
"The account number was changed": "A new card has been issued with a change in the card number.",
"The account was closed": "The account is closed and the card is no longer valid. Ask your customer for an alternative payment method.",
"The expiry was changed": "A new card has been issued with an updated expiry date. In most cases the card number remains unchanged.",
"The issuing bank does not participate in the update program": "Returned for Real Time Account Updater only. It is not known whether an account update is available.",
"Contact the cardholder for updated information": "A match was found but you may need to contact the cardholder for updated card details. This could be due to cardholder opt-out or other reasons.",
"No match found": "The BIN range is enrolled for account updates, but no match was found for the card account. One reason for this may be that the card issuer has recently changed.",
"No changes found": "No changes to the card account were found."
}
}
}
},
"value": {
"required": [
"amount",
"currency"
],
"type": "object",
"description": "An object that contains payment amount and currency.",
"properties": {
"amount": {
"type": "integer",
"description": "This is a whole number including the currency exponent (e.g. GBP has an exponent of 2, so for £2.50 supply:`250`)."
},
"currency": {
"type": "string",
"description": "The 3 digit currency code."
}
}
},
"events": {
"required": [
"eventName",
"timestamp"
],
"type": "array",
"description": "An array that contains the history of events of a payment.",
"items": {
"type": "object",
"description": "Name of the event.",
"oneOf": [
{
"$ref": "#/components/schemas/authorizationRequested"
},
{
"$ref": "#/components/schemas/authorizationSucceeded"
},
{
"$ref": "#/components/schemas/authorizationRefused"
},
{
"$ref": "#/components/schemas/authorizationFailed"
},
{
"$ref": "#/components/schemas/authorizationTimedOut"
},
{
"$ref": "#/components/schemas/incrementalAuthorizationRequested"
},
{
"$ref": "#/components/schemas/incrementalAuthorizationSucceeded"
},
{
"$ref": "#/components/schemas/incrementalAuthorizationRefused"
},
{
"$ref": "#/components/schemas/incrementalAuthorizationFailed"
},
{
"$ref": "#/components/schemas/incrementalAuthorizationTimedOut"
},
{
"$ref": "#/components/schemas/saleRequested"
},
{
"$ref": "#/components/schemas/saleSucceeded"
},
{
"$ref": "#/components/schemas/saleRefused"
},
{
"$ref": "#/components/schemas/saleFailed"
},
{
"$ref": "#/components/schemas/saleTimedOut"
},
{
"$ref": "#/components/schemas/settlementRequested"
},
{
"$ref": "#/components/schemas/settlementRequestSubmitted"
},
{
"$ref": "#/components/schemas/settlementRequestSubmissionFailed"
},
{
"$ref": "#/components/schemas/settlementRequestSubmissionTimedOut"
},
{
"$ref": "#/components/schemas/refundRequested"
},
{
"$ref": "#/components/schemas/refundRequestSubmitted"
},
{
"$ref": "#/components/schemas/refundRequestSubmissionFailed"
},
{
"$ref": "#/components/schemas/refundRequestSubmissionTimedOut"
},
{
"$ref": "#/components/schemas/cancellationRequested"
},
{
"$ref": "#/components/schemas/cancellationRequestSubmitted"
},
{
"$ref": "#/components/schemas/cancellationRequestSubmissionFailed"
},
{
"$ref": "#/components/schemas/cancellationRequestSubmissionTimedOut"
},
{
"$ref": "#/components/schemas/reversalRequested"
},
{
"$ref": "#/components/schemas/reversalRequestSubmitted"
},
{
"$ref": "#/components/schemas/reversalRequestSubmissionFailed"
},
{
"$ref": "#/components/schemas/reversalRequestSubmissionTimedOut"
}
],
"discriminator": {
"propertyName": "eventName",
"mapping": {
"authorizationRequested": "#/components/schemas/authorizationRequested",
"authorizationSucceeded": "#/components/schemas/authorizationSucceeded",
"authorizationRefused": "#/components/schemas/authorizationRefused",
"authorizationFailed": "#/components/schemas/authorizationFailed",
"authorizationTimedOut": "#/components/schemas/authorizationTimedOut",
"incrementalAuthorizationRequested": "#/components/schemas/incrementalAuthorizationRequested",
"incrementalAuthorizationSucceeded": "#/components/schemas/incrementalAuthorizationSucceeded",
"incrementalAuthorizationRefused": "#/components/schemas/incrementalAuthorizationRefused",
"incrementalAuthorizationFailed": "#/components/schemas/incrementalAuthorizationFailed",
"incrementalAuthorizationTimedOut": "#/components/schemas/incrementalAuthorizationTimedOut",
"saleRequested": "#/components/schemas/saleRequested",
"saleSucceeded": "#/components/schemas/saleSucceeded",
"saleRefused": "#/components/schemas/saleRefused",
"saleFailed": "#/components/schemas/saleFailed",
"saleTimedOut": "#/components/schemas/saleTimedOut",
"settlementRequested": "#/components/schemas/settlementRequested",
"settlementRequestSubmitted": "#/components/schemas/settlementRequestSubmitted",
"settlementRequestSubmissionFailed": "#/components/schemas/settlementRequestSubmissionFailed",
"settlementRequestSubmissionTimedOut": "#/components/schemas/settlementRequestSubmissionTimedOut",
"refundRequested": "#/components/schemas/refundRequested",
"refundRequestSubmitted": "#/components/schemas/refundRequestSubmitted",
"refundRequestSubmissionFailed": "#/components/schemas/refundRequestSubmissionFailed",
"refundRequestSubmissionTimedOut": "#/components/schemas/refundRequestSubmissionTimedOut",
"cancellationRequested": "#/components/schemas/cancellationRequested",
"cancellationRequestSubmitted": "#/components/schemas/cancellationRequestSubmitted",
"cancellationRequestSubmissionFailed": "#/components/schemas/cancellationRequestSubmissionFailed",
"cancellationRequestSubmissionTimedOut": "#/components/schemas/cancellationRequestSubmissionTimedOut",
"reversalRequested": "#/components/schemas/reversalRequested",
"reversalRequestSubmitted": "#/components/schemas/reversalRequestSubmitted",
"reversalRequestSubmissionFailed": "#/components/schemas/reversalRequestSubmissionFailed",
"reversalRequestSubmissionTimedOut": "#/components/schemas/reversalRequestSubmissionTimedOut"
}
}
}
},
"_links": {
"required": [
"self"
],
"type": "object",
"description": "Self link and next action links.
For any payment query against a payment processed on Card Payments v6 or lower, the action link we return is `payments:cancel`,`payments:refund` etc.",
"oneOf": [
{
"$ref": "#/components/schemas/selfLinkOnly"
},
{
"$ref": "#/components/schemas/authorizationSucceededLinks"
},
{
"$ref": "#/components/schemas/increaseAuthorizedAmountLinks"
},
{
"$ref": "#/components/schemas/sentForSettlementLinks"
},
{
"$ref": "#/components/schemas/fullSettleLinks"
},
{
"$ref": "#/components/schemas/partialSettleLinks"
},
{
"$ref": "#/components/schemas/fullRefundLinks"
},
{
"$ref": "#/components/schemas/partialRefundLinks"
},
{
"$ref": "#/components/schemas/fullCancelLinks"
},
{
"$ref": "#/components/schemas/partialCancelLinks"
},
{
"$ref": "#/components/schemas/reversalLinks"
}
],
"discriminator": {
"propertyName": "self",
"mapping": {
"Self link": "#/components/schemas/selfLinkOnly",
"Authorized": "#/components/schemas/authorizationSucceededLinks",
"Increase authorized amount": "#/components/schemas/increaseAuthorizedAmountLinks",
"Sent for settlement": "#/components/schemas/sentForSettlementLinks",
"Settle for full amount": "#/components/schemas/fullSettleLinks",
"Settle for partial amount": "#/components/schemas/partialSettleLinks",
"Refund full amount": "#/components/schemas/fullRefundLinks",
"Refund partial amount": "#/components/schemas/partialRefundLinks",
"Cancel full authorization": "#/components/schemas/fullCancelLinks",
"Cancel partial authorization": "#/components/schemas/partialCancelLinks",
"Reversal": "#/components/schemas/reversalLinks"
}
}
}
}
},
"pq_querybypaymentid_404_response": {
"type": "object",
"properties": {
"errorName": {
"type": "string",
"example": "paymentNotFound"
},
"message": {
"type": "string",
"example": "The payment you are trying to access does not exist."
}
}
},
"pq_querybydaterange_200_response": {
"required": [
"_links",
"_embedded"
],
"type": "object",
"properties": {
"_links": {
"required": [
"self"
],
"type": "object",
"description": "links to the pages.",
"properties": {
"self": {
"type": "object",
"description": "Self link to the page.",
"properties": {
"href": {
"type": "string",
"description": "First page as per the pageSize."
}
}
},
"next": {
"type": "object",
"description": "Next page link if the response contains more pages.",
"properties": {
"href": {
"type": "string",
"description": "Second page as per the pageSize."
}
}
}
}
},
"_embedded": {
"type": "object",
"properties": {
"payments": {
"type": "array",
"required": [
"timestamp",
"transactionReference",
"entity"
],
"description": "Array of payments within the date range.",
"items": {
"type": "object",
"properties": {
"timestamp": {
"type": "string",
"description": "Payment initial authorization time."
},
"paymentId": {
"$ref": "#/components/schemas/paymentId"
},
"transactionReference": {
"type": "string",
"description": "A unique reference, generated by you, used to identify a payment throughout its lifecycle."
},
"orderReference": {
"type": "string",
"description": "A reference, generated by you, that you can apply to one or more payments according to your business needs. You may reuse the same reference across multiple payments."
},
"narrative": {
"type": "object",
"description": "An object that contains identification and further details of the merchant.",
"properties": {
"line1": {
"type": "string",
"description": "First line of text that appears on your customer's statement."
},
"line2": {
"type": "string",
"description": "Second line of text that appears on your customer's statement."
}
}
},
"transactionType": {
"enum": [
"oneTime",
"cardOnFile",
"recurring"
],
"type": "string",
"description": "An object that contains transaction type."
},
"authorizationType": {
"enum": [
"authorization",
"sale"
],
"type": "string",
"description": "An object that contains authorization type."
},
"entity": {
"type": "string",
"description": "Merchant entity name."
},
"lastEvent": {
"$ref": "#/components/schemas/lastEvent"
},
"scheme": {
"required": [
"reference"
],
"type": "object",
"description": "An object containing information returned by the card scheme.",
"properties": {
"reference": {
"type": "string",
"description": "The reference returned by the scheme for this particular payment authorization.",
"example": "MCCOLXT1C0104 "
}
}
},
"issuer": {
"required": [
"authorizationCode"
],
"type": "object",
"description": "An object containing information returned by the issuer.",
"properties": {
"authorizationCode": {
"pattern": "^[a-zA-Z0-9]+$",
"type": "string",
"description": "A code returned by the card issuer for a successful authorization. Used in reconciliation and dispute management.",
"example": "T31306"
}
}
},
"token": {
"$ref": "#/components/schemas/tokenResponse"
},
"paymentInstrument": {
"$ref": "#/components/schemas/paymentInstrument"
},
"value": {
"required": [
"amount",
"currency"
],
"type": "object",
"description": "An object that contains payment amount and currency.",
"properties": {
"amount": {
"type": "integer",
"description": "This is a whole number including the currency exponent (e.g. GBP has an exponent of 2, so for £2.50 supply:`250`)."
},
"currency": {
"type": "string",
"description": "The 3 digit currency code."
}
}
},
"_links": {
"required": [
"self"
],
"type": "object",
"description": "link to retrieveByPaymentId.",
"properties": {
"self": {
"type": "object",
"description": "Self link to retrieveByPaymentId.",
"properties": {
"href": {
"type": "string",
"description": "RetrieveByPaymentId provides event history and next action links."
}
}
}
}
}
}
}
}
}
}
}
},
"pq_querybydaterange_400_response": {
"required": [
"errorName",
"message"
],
"type": "object",
"properties": {
"errorName": {
"type": "string",
"description": "The type of error.",
"example": "invalidPageSize"
},
"message": {
"type": "string",
"description": "A description of the error.",
"example": "Provided page size is not valid."
}
}
},
"pq_queryhistoricalpayments_200_response": {
"required": [
"_links",
"_embedded"
],
"type": "object",
"properties": {
"_links": {
"required": [
"self"
],
"type": "object",
"description": "Self link and next action links. The next action links are dependent on the lastEvent. Refer to the 'query for historical payments response' section for more details.",
"properties": {
"self": {
"type": "object",
"description": "Self link to the page.",
"properties": {
"href": {
"type": "string",
"description": "Self link to the page."
}
}
},
"payments:cancel": {
"type": "object",
"description": "Next action links.",
"properties": {
"href": {
"type": "string",
"description": "Next action links."
}
}
},
"payments:settle": {
"type": "object",
"description": "Next action links.",
"properties": {
"href": {
"type": "string",
"description": "Next action links."
}
}
},
"payments:partialSettle": {
"type": "object",
"description": "Next action links.",
"properties": {
"href": {
"type": "string",
"description": "Next action links."
}
}
}
}
},
"_embedded": {
"type": "object",
"properties": {
"payments": {
"type": "array",
"description": "Array of payments.",
"items": {
"type": "object",
"properties": {
"lastEvent": {
"type": "string",
"description": "The last event of a payment. Possible event values are:- `Authorized`
- `Refused`
- `Sent for Cancellation`
- `Sent for Refund`
- `Sent for Settlement`
- `Unknown`
"
},
"paymentInstrument": {
"$ref": "#/components/schemas/paymentInstrument"
},
"value": {
"required": [
"amount",
"currency"
],
"type": "object",
"description": "An object that contains payment amount and currency.",
"properties": {
"amount": {
"type": "integer",
"description": "This is a whole number including the currency exponent (e.g. GBP has an exponent of 2, so for £2.50 supply:`250`)."
},
"currency": {
"type": "string",
"description": "The 3 digit currency code."
}
}
}
}
}
}
}
}
}
},
"pq_queryhistoricalpayments_400_response": {
"required": [
"errorName",
"message"
],
"type": "object",
"properties": {
"errorName": {
"type": "string",
"description": "The type of error.",
"example": "entityIsNotConfigured"
},
"message": {
"type": "string",
"description": "A description of the error",
"example": "Entity is not configured to use this resource"
}
}
},
"fpanLastFour": {
"pattern": "^[0-9]+$",
"type": "string",
"minLength": 4,
"maxLength": 4,
"example": "1111",
"description": "The last four digits of the actual card, where this was submitted in an authorization request that used a network token or a [mobile wallet](/products/wallets#submitting-card-metadata-to-worldpay) (encrypted or decrypted) `paymentInstrument`. Commonly referred to as the Funding Primary Account Number (FPAN)."
},
"tokenResponse": {
"type": "object",
"description": "If a token was created as part of your payment authorization request, the details are included in this object. This is currently available for [modular integrations](/products/modular/) only.",
"properties": {
"href": {
"type": "string",
"format": "uri",
"description": "An `https` address for an Access Worldpay Token.",
"example": "https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0NzI0NE1rdUtjMUFJdjYxVnlibWZuUT0ifQ"
},
"tokenId": {
"maxLength": 21,
"minLength": 15,
"pattern": "^[0-9A-HJ-NP-Z]+$",
"description": "Worldpay's internal identifier for a token.",
"type": "string",
"example": "9897039852081922819"
}
}
},
"paymentInstrument": {
"type": "object",
"description": "An object that contains information about the payment type.",
"properties": {
"type": {
"enum": [
"card/plain",
"card/token",
"card/checkout",
"card/wallet+applepay",
"card/wallet+googlepay",
"card/networkToken",
"card/networkToken+applepay",
"card/networkToken+googlepay",
"card/network",
"card/plain+masked",
"card/network+masked"
],
"type": "string",
"description": "The type of payment instrument used for this payment."
},
"card": {
"type": "object",
"description": "An object that contains information about the card used.",
"properties": {
"number": {
"type": "object",
"description": "An object that contains information about the card number.",
"properties": {
"cardBin": {
"pattern": "^[0-9*]+$",
"type": "string",
"description": "The card BIN (Bank Identification Number) is the first 6 or 8 digits of the card number, and can be used to identify the card issuer, the card brand(s) (e.g. Visa, Cartes Bancaires), and the country. Card BINs are used to route transactions, check card capabilities, and in fraud assessments.",
"example": "444433"
},
"last4Digits": {
"pattern": "^[0-9*]+$",
"type": "string",
"description": "The last four digits of the card. Some characters may be obfuscated with a `*` if the PAN length is less than 16 characters.",
"example": "1111"
},
"fpanLastFour": {
"$ref": "#/components/schemas/fpanLastFour"
}
}
},
"category": {
"type": "string",
"description": "Whether the card is classed as a consumer card or a card for commercial use.",
"enum": [
"commercial",
"consumer"
]
},
"countryCode": {
"maxLength": 2,
"minLength": 2,
"pattern": "^[A-Z]+$",
"type": "string",
"description": "The [ISO 3166-1 Alpha-2 format](/products/reference/supported-countries-currencies#iso-country-codes) country code that the card was issued in. May return `N/A` where the country is unknown.",
"example": "GB"
},
"expiryDate": {
"type": "object",
"description": "The expiry date of the card or network token (where the supplied paymentInstrument was `card/wallet+applepay`, `card/wallet+googlepay`, `card/networkToken`, `card/networkToken+applepay` or `card/networkToken+googlepay`).",
"properties": {
"month": {
"type": "integer"
},
"year": {
"type": "integer"
}
}
},
"issuerName": {
"type": "string",
"description": "The name of the card issuer.",
"example": "AN ISSUING BANK LTD"
},
"fundingType": {
"type": "string",
"description": "How the card is funded.",
"enum": [
"credit",
"debit",
"prepaid",
"chargeCard",
"deferredDebit"
]
},
"brand": {
"type": "string",
"description": "The card brand that the transaction was processed with. Sometimes referred to as the network or scheme.",
"example": "visa"
},
"paymentAccountReference": {
"type": "string",
"description": "The payment account reference (PAR) is a non-financial reference that uniquely identifies the underlying cardholder account. This allows you to correlate payments made from the same account with differing instruments (e.g. `card/plain` and `card/wallet+applepay`), where the same account funds the transaction. A PAR cannot be used to initiate a payment.",
"example": "Q1HJZ28RKA1EBL470G9XYG90R5D3E"
}
}
}
}
}
},
"securitySchemes": {
"BasicAuth": {
"type": "http",
"scheme": "basic"
}
}
},
"security": [
{
"BasicAuth": []
}
]
}