REQUEST

Field Name	Description	Type	Required	Constraints
logCode	The log code of the dispute	String	Optional

Sample Request

{{base_url}}/api/v1/disputes/IBTC0II62943

RESPONSE

Field Name	Description	Type	Constraint
logCode	The log code of the dispute	String
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	The domain code of the merchant, if applicable	String
merchant	The domain name of the merchant, if applicable	String
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	String
transactionType	The type of the transaction	String	refer to Get Transaction Types
transactionAmount	The amount of the transaction	String
surchargeAmount	The surcharge (or fee) of the transaction, if applicable	String
transactionCurrencyCode	The currency of the transaction. Format: ISO 4217 numeric	String
settlementAmount	The settlement amount of the transaction	String
settlementCurrencyCode	The currency of the transaction settlement. Format: ISO 4217 numeric	String
terminalType	The type of the terminal	String
disputeAmountType	The type of the dispute amount	Enum	FULL or PARTIAL
disputeAmount	The amount of the dispute	String
additionalInfo	Any additional data from the transaction	JSON String
reasonCode	The code of reason of the dispute	String	refer to Get Dispute Reasons
reason	The reason for the dispute	String	refer to Get Dispute Reasons
category	The category of the dispute	String	refer to Get Dispute Categories
region	The region of the dispute	String
merchantDisputant	Indicates whether the dispute is managed by the merchant or the acquirer	Boolean
domainCode	The domain code of the issuer of the dispute	String
status	The current status of the dispute	String
previousStatus	The previous status of the dispute	String
statusStartDate	The UTC date and time the current status began	DateTime
createdBy	The user that logged the dispute	String
createdOn	The UTC date and time the dispute was logged	DateTime
accountNumber	The transaction account number	String
merchantEmail	The email address of the merchant if applicable	String
pan	The masked PAN of the card used in the transaction	String
evidence	A list of all the evidence attached to the dispute	JSON Arrays
journal	An array of all attached journals	JSON Array

Sample Response

{
    "logCode": "IBTC0II62943",
    "issuerCode": "IBTC",
    "issuer": "Stanbic IBTC Bank",
    "acquirerCode": "FBN",
    "acquirer": "FIRST BANK OF NIGERIA",
    "merchantCode": "",
    "merchant": "",
    "customerReference": "506120*********8033",
    "transactionStore": "RJService",
    "transactionReference": "136919902261_902261_20086919_-10000.00_0200",
    "transactionDate": "2023-04-11T11:00:00Z",
    "transactionType": "AGENCY_BANKING_TRANSFER",
    "transactionAmount": "NGN 100.00",
    "surchargeAmount": "NGN 0.00",
    "transactionCurrencyCode": "566",
    "settlementAmount": "NGN 0.00",
    "settlementCurrencyCode": "566",
    "terminalType": "2",
    "disputeAmountType": "Full",
    "disputeAmount": "NGN 100.00",
    "additionalInfo": {
        "Card Acceptor Code": "200001119220077",
        "Card Acceptor Location": "WT|ABUBAKAR MUHAMMAD MUST       ZARIA NG",
        "Card Scheme": "Verve",
        "Has Merchant": true,
        "Merchant Type": "REGULAR",
        "Response Code": "00",
        "Retrieval Reference Number": "136919902261",
        "Settled": true,
        "Stan": "902261",
        "Terminal Id": "20086919"
    },
    "reasonCode": "RG",
    "reason": "Non-Receipt of Goods and Services",
    "category": "Chargeback",
    "region": "DOMESTIC_AGENCY_TRANSFERS",
    "merchantDisputant": false,
    "domainCode": "IBTC",
    "status": "Accepted",
    "previousStatus": "Chargeback",
    "statusStartDate": "2023-09-23T22:46:58.637Z",
    "evidence": [],
    "journal": [
        {
            "detail": "Dispute status updated: Chargeback to Accepted",
            "addedBy": "Emmanuel.Kpoudosu@FBN",
            "addedOn": "2023-09-23T22:46:58.653Z"
        },
        {
            "detail": "Dispute comment added: Accept with comment",
            "addedBy": "Emmanuel.Kpoudosu@FBN",
            "addedOn": "2023-09-23T22:46:58.653Z"
        }
    ],
    "createdBy": "Emmanuel.Kpoudosu@ISW",
    "createdOn": "2023-09-23T22:30:07.087Z",
    "lastUpdatedBy": "Emmanuel.Kpoudosu@FBN",
    "lastUpdatedOn": "2023-09-23T22:46:58.653Z",
    "pan": "506120*********8033",
    "statusActions": []
}

200200

400400