Get Transaction

REQUEST

Field Name	Description	Type	Required	Constraints
transaction_type	The transaction type derived from the transaction group	String	Required	See Get Transaction Types
reference	The reference used to identify the transaction.	String	Required

Sample Request

{{baseurl}}/api/v1/transactions/types/AGENCY_BANKING_TRANSFER/references/136919902261_902261_20086919-10000.00_0200

RESPONSE

Field Name	Description	Type	Constraints
issuerCode	The domain code of the issuer	String
issuer	The domain name of the issuer	String
acquirerCode	The domain code of the acquirer	String
acquirer	The domain name of the acquirer	String
merchantCode	If applicable, the domain code of the merchant	String
merchant	If applicable, the domain name of the merchant	String
merchantType	If applicable, the type of the merchant.	Enum	Regular, TSA, or Government
customerReference	The reference of the customer	String
transactionStore	The store of the transaction	String
transactionReference	The unique reference of the transaction in the store	String
transactionDate	The UTC date and time of the transaction	DateTime
surchargeAmount	If applicable, the surcharge (or fee) of the transaction	Long
transactionCurrencyCode	The currency of the transaction. Format: ISO 4217 numeric	String
settlementAmount	If applicable, the settlement amount of the transaction	Long
settlementCurrencyCode	If applicable, the currency of the transaction settlement. Format: ISO 4217 numeric	String
terminalType	The type of the terminal	String
terminalId	The unique identifier of the terminal	String
stan	If applicable, the system trace audit number (Postilion)	String
pan	If applicable, the masked PAN of the card used in the transaction	String
retrievalReferenceNumber	if applicable, the retrieval reference number of the transaction	String
cardScheme	If applicable, the scheme of the card used in the transaction	String
cardAcceptorCode	If applicable, the unique identifier of the card acceptor	String
cardAcceptorLocation	If applicable, the location of the card acceptor	String
sourceNodeName	If applicable, the name of the source node (Postilion)	String
sinkNodeName	If applicable, the name of the sink node (Postilion)	String
responseCode	The response code of the transaction	String
responseDescription	The user-friendly description of the response code	String
settled	The settlement status of the transaction	Boolean
hasMerchant		Boolean
region	The region of the dispute	String
accountNumber	if applicable, transaction account number	String
additionalInfo	If applicable, any additional relevant data not captured by any field above	String
disputeCategories	A list of the available dispute categories	JSON Array	See Get Dispute Categories
disputeCategoryErrors	For these reasons, the transaction cannot be disputed using the dispute categories listed.	JSON String

Sample Response

{
    "issuerCode": "VDM",
    "issuer": "VFD MFB",
    "acquirerCode": "ZIB",
    "acquirer": "ZENITH BANK INTERNATIONAL",
    "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,
    "region": "DOMESTIC_AGENCY_TRANSFERS",
    "additionalInfo": {},
    "accountNumber": "1012305241",
    "disputeCategories": [
        "Inquiry",
        "Chargeback",
        "Government Biller",
        "TSA Biller",
        "Refund",
        "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"
        ]
    }
}

Get Transaction

API

Developers