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.
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
GET /acceptor/rest/transactions/{instId}/{transactionId}curl -X GET "{targetEnvironmentPath}/acceptor/rest/transactions/{instId}/{transactionId}" \
-u "{apiUser}:{apiPassword}" \
-H "Accept: application/json"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"
}- The transactionId is ours, as returned when the transaction was submitted. To look one up by your own reference, use
byRefinstead. - history carries an entry per state the transaction passed through, so a transaction that went out for 3D Secure shows the
U100suspension before its final state.
If a network token was provisioned or used during the transaction, or provisioning was attempted and failed, the card also carries a networkToken section:
Get a transaction that provisioned a network token
GET /acceptor/rest/transactions/{instId}/{transactionId}curl -X GET "{targetEnvironmentPath}/acceptor/rest/transactions/{instId}/{transactionId}" \
-u "{apiUser}:{apiPassword}" \
-H "Accept: application/json"HTTP/1.1 200
{
"processing": {
"model": "MANAGE",
"authResponse": {
"statusCode": "00",
"acquirerName": "Barclays Merchant Services",
"message": "AUTH CODE:972862",
"authCode": "972862",
"gatewayReference": "f4ecad065c8ee86298f1aa5a381602ba",
"gatewayMessage": "AUTH CODE:972862",
"avsAddressCheck": "NOT_CHECKED",
"avsPostcodeCheck": "NOT_CHECKED",
"cv2Check": "MATCHED",
"status": "AUTHORISED"
},
"route": "CPE"
},
"paymentMethod": {
"registered": true,
"card": {
"cardToken": "MT_HKJ7WDnpRtWRUkiXT6paFg",
"new": true,
"cardType": "VISA_DEBIT",
"cardUsageType": "DEBIT",
"cardScheme": "VISA",
"cardCategory": "DEBIT",
"maskedPan": "980200******9536",
"expiryDate": "1229",
"issuer": "PAY360 TESTING",
"issuerCountry": "ZZZ",
"cardHolderName": "John Smith",
"networkToken": {
"status": "ACTIVE",
"usage": "PROVISIONED",
"expiryDate": "0130"
}
},
"billingAddress": {},
"paymentClass": "CARD",
"reuse": {
"storage": "NEW",
"agreement": "ADHOC",
"receivedSchemeReference": "1G73RDVQJQNNZS"
}
},
"customer": {
"merchantRef": "JOHN_SMITH_002",
"displayName": "John Smith",
"registered": true
},
"transaction": {
"status": "SUCCESS",
"stage": "COMPLETE",
"type": "PAYMENT",
"amount": 15.0,
"currency": "GBP",
"customerInitiated": true
}
}- paymentMethod.card.networkToken is present only when a network token was provisioned or used during the transaction, or when provisioning was attempted and failed. It records the token as it was at that time: usage is
PROVISIONEDhere, and a later transaction with the same merchant token would showUSED.
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
GET /acceptor/rest/transactions/{instId}/byRefcurl -X GET "{targetEnvironmentPath}/acceptor/rest/transactions/{instId}/byRef?merchantRef={merchantRef}" \
-u "{apiUser}:{apiPassword}" \
-H "Accept: application/json"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"
}- 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
404withA400 No such transaction, not an empty array.