Use this to retrieve a single transaction for dispute
Resource URL: <base url>/groups/<transaction group>/channels/<transaction group channel>
HTTP Verb: GET
Authentication: User Access Token
REQUEST
Sample Request
<Base URL>types/BillPayment/references/64857797
RESPONSE
| Field | Description |
|---|---|
| accountNumber | if applicable, transaction account number |
| acquirer | The domain name of the acquirer |
| acquirerCode | The domain code of the acquirer |
| acquirerCountry | The ISO Alpha-2 country code of the acquirer |
| additionalInfo | If applicable, any additional relevant data not captured by any field above |
| cardAcceptorCode | If applicable, the unique identifier of the card acceptor |
| cardAcceptorLocation | If applicable, the location of the card acceptor |
| cardScheme | If applicable, the scheme of the card used in the transaction |
| customerReference | The reference of the customer |
| disputeCategories | The dispute categories |
| disputeCategoryErrors | The reasons, per dispute category, a dispute cannot be logged against the transaction |
| issuer | The domain name of the issuer |
| issuerCode | The domain code of the issuer |
| issuerCountry | The ISO Alpha-2 country code of the issuer |
| merchant | If applicable, the domain name of the merchant |
| merchantCategoryCode | If applicable, the category of the merchant |
| merchantCode | If applicable, the domain code of the merchant |
| merchantCountry | If applicable, the ISO Alpha-2 country code of the merchant |
| merchantReference | If applicable, the unique reference of the transaction in the merchant’s system |
| merchantType | If applicable, the type of the merchant. Either Regular, TSA, or Government |
| pan | If applicable, the PAN of the card used in the transaction |
| region | The region of the dispute |
| responseCode | The response code of the transaction |
| responseDescription | The user-friendly description of the response code |
| schemeAmount | If applicable, the amount of the transaction from the card scheme’s system |
| schemeCurrencyCode | If applicable, the currency of the transaction from the card scheme’s system. Format: ISO 4217 numeric |
| settled | The settlement status of the transaction |
| settlementAmount | If applicable, the settlement amount of the transaction |
| settlementCurrencyCode | If applicable, the currency of the transaction settlement. Format: ISO 4217 numeric |
| sinkNodeName | If applicable, the name of the sink node (Postilion) |
| sourceNodeName | If applicable, the name of the source node (Postilion) |
| stan | If applicable, the system trace audit number (Postilion) |
| surchargeAmount | If applicable, the surcharge (or fee) of the transaction |
| terminalId | The unique identifier of the terminal |
| terminalType | The type of the terminal |
| transactionAmount | The amount of the transaction |
| transactionCurrencyCode | The currency of the transaction. Format: ISO 4217 numeric |
| transactionDate | The UTC date and time of the transaction |
| transactionReference | The unique reference of the transaction in the store |
| transactionStore | The store of the transaction |
| transactionType | The type of the transaction |
Sample Response
{"issuerCode": "ZIB","issuer": "Zenith International Bank","acquirerCode": "WEMA","acquirer": "WEMA Bank","merchantCode": "","merchant": "","merchantType": "Regular","merchantReference": "","customerReference": "09096813886","transactionStore": "PAYDIRECT","transactionReference": "64857797","transactionDate": "2018-05-30T20:15:33Z","transactionType": "BillPayment","transactionAmount": "NGN 1,426.00","surchargeAmount": "NGN 0.00","transactionCurrencyCode": "566","terminalType": "ATM","terminalId": "10571967","pan": "539941******8691","cardScheme": "MasterCard","responseCode": "00","responseDescription": "Approved or completed successfully","settled": true,"region": "Domestic Nigeria Bill Payment","additionalInfo": {"Payment Reference": "ZIB|ATM|10571967|MNS|300518211533|KMWRKNT4"},"disputeCategories": ["Inquiry","Chargeback","Government Biller","TSA Biller","Refund","Good Faith"],"disputeCategoryErrors": {"TSA Biller": ["Transaction cannot be disputed because it involves a Regular biller"],"Inquiry": ["Transaction cannot be disputed because it involves a MasterCard card"],"Refund": ["Transaction cannot be disputed because you are not the Acquirer"],"Government Biller": ["Transaction cannot be disputed because it involves a Regular biller"]}}