Get Transaction

Use this to retrieve a single transaction for dispute


Field NameDescriptionTypeRequiredConstraints
transaction_typeThe transaction type derived from the transaction groupStringRequiredSee Get Transaction Types
referenceThe reference used to identify the transaction.StringRequired

Sample Request



Field NameDescriptionTypeConstraints
issuerCodeThe domain code of the issuerString
issuerThe domain name of the issuerString
acquirerCodeThe domain code of the acquirerString
acquirerThe domain name of the acquirerString
merchantCodeIf applicable, the domain code of the merchantString
merchantIf applicable, the domain name of the merchantString
merchantTypeIf applicable, the type of the merchant.EnumRegular, TSA, or Government
customerReferenceThe reference of the customerString
transactionStoreThe store of the transactionString
transactionReferenceThe unique reference of the transaction in the storeString
transactionDateThe UTC date and time of the transactionDateTime
surchargeAmountIf applicable, the surcharge (or fee) of the transactionLong
transactionCurrencyCodeThe currency of the transaction. Format: ISO 4217 numericString
settlementAmountIf applicable, the settlement amount of the transactionLong
settlementCurrencyCodeIf applicable, the currency of the transaction settlement. Format: ISO 4217 numericString
terminalTypeThe type of the terminalString
terminalIdThe unique identifier of the terminalString
stanIf applicable, the system trace audit number (Postilion)String
panIf applicable, the masked PAN of the card used in the transactionString
retrievalReferenceNumberif applicable, the retrieval reference number of the transactionString
cardSchemeIf applicable, the scheme of the card used in the transactionString
cardAcceptorCodeIf applicable, the unique identifier of the card acceptorString
cardAcceptorLocationIf applicable, the location of the card acceptorString
sourceNodeNameIf applicable, the name of the source node (Postilion)String
sinkNodeNameIf applicable, the name of the sink node (Postilion)String
responseCodeThe response code of the transactionString
responseDescriptionThe user-friendly description of the response codeString
settledThe settlement status of the transactionBoolean
regionThe region of the disputeString
accountNumberif applicable, transaction account numberString
additionalInfoIf applicable, any additional relevant data not captured by any field aboveString
disputeCategoriesA list of the available dispute categoriesJSON ArraySee Get Dispute Categories
disputeCategoryErrorsFor these reasons, the transaction cannot be disputed using the dispute categories listed.JSON String

Sample Response

    "issuerCode": "VDM",
    "issuer": "VFD MFB",
    "acquirerCode": "ZIB",
    "merchantCode": "",
    "merchant": "",
    "merchantType": "Regular",
    "customerReference": "506136******2056_1012305241",
    "transactionStore": "RJService",
    "transactionReference": "000000007078_007078_2TEPH519_-100000.00_0200",
    "transactionDate": "2023-08-22T08:01:41Z",
    "transactionType": "AGENCY_BANKING_TRANSFER",
    "transactionAmount": "NGN 1,000.00",
    "surchargeAmount": "NGN 0.00",
    "transactionCurrencyCode": "566",
    "settlementAmount": "NGN 1,000.00",
    "settlementCurrencyCode": "566",
    "terminalType": "2",
    "terminalId": "2TEPH519",
    "stan": "007078",
    "pan": "506136******2056",
    "retrievalReferenceNumber": "000000007078",
    "cardScheme": "Verve",
    "cardAcceptorCode": "2TEPLA000000002",
    "cardAcceptorLocation": "T Olakazzy big Ltd  007078 2TEPH519 LANG",
    "sourceNodeName": "SWTTAPTsrc",
    "sinkNodeName": "SWTASPsnk",
    "responseCode": "00",
    "responseDescription": "Approved",
    "settled": true,
    "hasMerchant": true,
    "additionalInfo": {},
    "accountNumber": "1012305241",
    "disputeCategories": [
        "Government Biller",
        "TSA Biller",
        "Good Faith",
        "Co Acquired"
    "disputeCategoryErrors": {
        "Co Acquired": [
            "Transaction cannot be disputed because you are not the CoAcquirer"
        "TSA Biller": [
            "Transaction cannot be disputed because it involves a Regular biller"
        "Government Biller": [
            "Transaction cannot be disputed because it involves a Regular biller"
        "Inquiry": [
            "Transaction cannot be disputed because it involves a Verve card"
        "Refund": [
            "Transaction cannot be disputed because you are not the Acquirer"
Click Try It! to start a request and see the response here!