Cards & Wallets · Access Your Data

Retrieve a Transaction

If you want to receive on-demand transaction information you can request details using the Get Transaction request. Not only does the request return processed transactions but it will also return transactions that are in-flight. For example, that are currently being processed for 3D Secure or that you have suspended due to a call-back.

We’ll send you everything we know about the transaction including custom fields captured, 3D Secure information, data we’ve found out through our third party data sources (for example, supplementary card information) as well as information from the authoriser i.e. Authorisation responses, messages and codes, AVS and CV2 responses.

You can request a transaction using our reference or your own.

Retrieve a single transaction

Request the transaction by the transactionId we returned when it was submitted. A single transaction is returned.

API example
Get single transaction by ID
EndpointDefinition
GET /acceptor/rest/transactions/{instId}/{transactionId}
cURL
curl -X GET "{targetEnvironmentPath}/acceptor/rest/transactions/{instId}/{transactionId}" \
  -u "{apiUser}:{apiPassword}" \
  -H "Accept: application/json"
Response
HTTP/1.1 200

{
  "locale": "en",
  "processing": {
    "model": "MANAGE",
    "authResponse": {
      "statusCode": "00",
      "acquirerName": "Barclays Merchant Services",
      "message": "AUTH CODE:829731",
      "authCode": "829731",
      "gatewayReference": "5600ec7fd5436bafdb2c856572ecc524",
      "gatewayMessage": "AUTH CODE:829731",
      "avsAddressCheck": "NOT_CHECKED",
      "avsPostcodeCheck": "NOT_CHECKED",
      "cv2Check": "MATCHED",
      "status": "AUTHORISED"
    },
    "route": "CPE"
  },
  "paymentMethod": {
    "registered": false,
    "card": {
      "cardFingerprint": "2iA8NX1t9lLPFkC8My0eilIvVms=",
      "new": true,
      "cardType": "MC_DEBIT",
      "cardUsageType": "DEBIT",
      "cardScheme": "MASTERCARD",
      "cardCategory": "DEBIT",
      "maskedPan": "990000******0258",
      "expiryDate": "1236",
      "issuer": "PAY360 TESTING",
      "issuerCountry": "GBR",
      "cardHolderName": "John Test"
    },
    "billingAddress": {
      "line1": "",
      "line2": "",
      "line3": "",
      "line4": "",
      "city": "",
      "region": "",
      "postcode": ""
    },
    "paymentClass": "CARD",
    "reuse": {
      "storage": "NONE"
    }
  },
  "threeDSecure": {
    "versionsAttempted": [
      {
        "version": 2,
        "availability": "ISSUER_NO_3DS"
      }
    ]
  },
  "customer": {
    "ip": "20.52.242.4",
    "registered": false
  },
  "transaction": {
    "transactionId": "10253428359",
    "merchantRef": "TXN-0001",
    "merchantDescription": "Sample Payment",
    "status": "SUCCESS",
    "stage": "COMPLETE",
    "type": "PAYMENT",
    "amount": 25.0,
    "consumerSpend": 25.0,
    "currency": "GBP",
    "transactionTime": "2026-08-26T14:37:46.218+01:00",
    "receivedTime": "2026-08-26T14:37:46.218+01:00",
    "channel": "WEB",
    "customerInitiated": true
  },
  "sessionId": "SMjpYub43Z5lKH5Mpwrs99qOZ",
  "history": [
    {
      "transactionStatus": "SUCCESS",
      "reasonCode": "S100",
      "reasonMessage": "Authorised",
      "timeStamp": "2026-08-26T14:37:46.525+01:00"
    }
  ],
  "strongCustomerAuthentication": {
    "transactionType": "GOODS_OR_SERVICES"
  },
  "followUpStatus": {},
  "link": [
    {
      "href": "https://api.mite.pay360.com/acceptor/rest/transactions/{instId}/10253428359",
      "rel": "self"
    }
  ]
}
HTTP/1.1 404

{
  "status": "FAILED",
  "reasonCode": "A400",
  "reasonMessage": "No such transaction"
}
Notes:
  • The transactionId is ours, as returned when the transaction was submitted. To look one up by your own reference, use byRef instead.
  • history carries an entry per state the transaction passed through, so a transaction that went out for 3D Secure shows the U100 suspension before its final state.

Retrieve transactions by your own reference

Request transactions by the merchantRef you sent with them. Because your reference may have been used more than once — a retried payment, for instance — an array is returned. A reference that matches nothing is a 404 with A400 No such transaction, rather than an empty array.

API example
Get transactions by merchant reference
EndpointDefinition
GET /acceptor/rest/transactions/{instId}/byRef
cURL
curl -X GET "{targetEnvironmentPath}/acceptor/rest/transactions/{instId}/byRef?merchantRef={merchantRef}" \
  -u "{apiUser}:{apiPassword}" \
  -H "Accept: application/json"
Response
HTTP/1.1 200

[
  {
    "locale": "en",
    "processing": {
      "model": "MANAGE",
      "authResponse": {
        "statusCode": "00",
        "acquirerName": "Barclays Merchant Services",
        "message": "AUTH CODE:217892",
        "authCode": "217892",
        "gatewayReference": "7603f3a63e1786dc5ae8a753d54fc7cd",
        "gatewayMessage": "AUTH CODE:217892",
        "avsAddressCheck": "NOT_CHECKED",
        "avsPostcodeCheck": "NOT_CHECKED",
        "cv2Check": "MATCHED",
        "status": "AUTHORISED"
      },
      "route": "CPE"
    },
    "paymentMethod": {
      "registered": false,
      "card": {
        "cardFingerprint": "IkNwdkR7LUV6VNjJVFeTg+mfPQc=",
        "new": true,
        "cardType": "MC_DEBIT",
        "cardUsageType": "DEBIT",
        "cardScheme": "MASTERCARD",
        "cardCategory": "DEBIT",
        "maskedPan": "990000******5159",
        "expiryDate": "1236",
        "issuer": "PAY360 TESTING",
        "issuerCountry": "GBR",
        "cardHolderName": "John Test"
      },
      "billingAddress": {
        "line1": "",
        "line2": "",
        "line3": "",
        "line4": "",
        "city": "",
        "region": "",
        "postcode": ""
      },
      "paymentClass": "CARD",
      "reuse": {
        "storage": "NONE"
      }
    },
    "threeDSecure": {
      "scheme": "MASTERCARD_IDENTITY_CHECK",
      "status": "AUTHENTICATED",
      "eci": "02",
      "version": 2,
      "protocolVersion": "2.2.0",
      "threeDSServerTransId": "27788598-4e31-4b23-92d5-f761f4c99bcc",
      "dsTransactionId": "a043fe3a-1cf9-43a0-a7e0-1e38393d9f8c",
      "acsTransactionId": "93c729b1-dbe2-4e38-a880-c37a43c6d59f",
      "challengeRequest": "NO_PREFERENCE",
      "frictionless": false,
      "versionsAttempted": [
        {
          "version": 2,
          "availability": "AVAILABLE"
        }
      ]
    },
    "customer": {
      "ip": "20.52.242.4",
      "registered": false
    },
    "transaction": {
      "transactionId": "10253429078",
      "merchantRef": "aReference",
      "merchantDescription": "Sample Payment",
      "status": "SUCCESS",
      "stage": "COMPLETE",
      "type": "PAYMENT",
      "amount": 25.0,
      "consumerSpend": 25.0,
      "currency": "GBP",
      "transactionTime": "2026-08-26T22:15:28.997+01:00",
      "receivedTime": "2026-08-26T22:15:28.997+01:00",
      "channel": "WEB",
      "customerInitiated": true
    },
    "sessionId": "SMjp3Pw8HfMVFooitySdERWIl",
    "history": [
      {
        "transactionStatus": "PENDING",
        "reasonCode": "U100",
        "reasonMessage": "Suspended pending Three D Secure process",
        "timeStamp": "2026-08-26T22:15:29.216+01:00"
      },
      {
        "transactionStatus": "SUCCESS",
        "reasonCode": "S100",
        "reasonMessage": "Authorised",
        "timeStamp": "2026-08-26T22:15:34.923+01:00"
      }
    ],
    "strongCustomerAuthentication": {
      "transactionType": "GOODS_OR_SERVICES"
    },
    "followUpStatus": {},
    "link": [
      {
        "href": "https://api.mite.pay360.com/acceptor/rest/transactions/{instId}/10253429078",
        "rel": "self"
      }
    ]
  }
]
HTTP/1.1 404

{
  "status": "FAILED",
  "reasonCode": "A400",
  "reasonMessage": "No such transaction"
}
Notes:
  • A merchant reference need not be unique, so the response is an array — every transaction carrying that merchantRef is returned, whatever its status.
  • A reference that matches nothing is a 404 with A400 No such transaction, not an empty array.