Get transaction details

Retrieve data about a specific transaction.

Get a transaction's details

GET

/v1/transactions/{merchant}/{site}

Request example

To get a transaction's details, you'll need to supply the merchant and site associated with the transaction, and either its merchantTransactionId or its systemTransactionId.

Use the following request example to get a transaction's details using a merchant transaction ID.

curl --request GET \
     --url https://api-services.pxp.io/api/v1/transactions/MERCHANT-1/SITE-1?merchantTransactionId=ECOM-001 \
     --header 'accept: application/json'

Path parameters

Parameter	Description
`merchant` string (≤ 10 characters) required	The unique merchant identifier associated with this transaction, as assigned by PXP.
`site` string (≤ 10 characters) required	The unique site identifier associated with this transaction, as assigned by PXP.

Query parameters

Parameter	Description
`merchantTransactionId` string (≤ 50 characters) required	The unique identifier that you assigned to this transaction.
`systemTransactionId` string (≤ 40 characters) required	The unique identifier assigned to this transaction by PXP.

Response example

If your request is successful, you'll receive a 200 response containing the transaction details.

{
  "systemTransactionId": "1ed768bb-e88a-4636-91ae-67927ccbb02b",
  "state": "Authorised",
  "stateMessage": "Transaction Authorised",
  "transactionMethod": {
    "intent": "Authorisation",
    "fundingType": "Card",
    "entryType": "Ecom"
  },
  "merchant": "MERCHANT-1",
  "site": "SITE-1",
  "merchantTransactionId": "ECOM-001",
  "merchantTransactionDate": "2024-01-27T08:51:02.826Z",
  "amounts": {
    "transactionValue": 50.05,
    "currencyCode": "EUR"
  },
  "shopper": {
    "id": "Shopper_01",
    "firstName": "John",
    "lastName": "Doe",
    "dateOfBirth": "2022-01-26T00:00:00.000Z",
    "email": "shopper@example.com"
  }
}