Fetch Dispute

To fetch dispute using disputeId

Environment

Environment	Http Method	API
`Sandbox`	`GET`	https://api-preprod.phonepe.com/apis/pg-sandbox/v1/disputes/{disputeId}
`Production`	`GET`	https://api.phonepe.com/apis/pg/v1/disputes/{disputeId}

Request

Request Headers

Header Name	Header Value
`Content-Type`	application/json
`Authorization`	O-Bearer <access_token>

Response

{
    "merchantId": "merchantId",
    "disputeId": "D1234",
    "merchantOrderId": "MO2329",
    "orderId": "OMO241",
    "transactionId": "OM4564",
    "transactionCompletedAt": <epoch-timestamp>,
    "transactionAmount": 1000,
    "disputeAmount": 1000,
    "refundAmount": 1000,
    "contestAmount": 0,
    "status": "LOST",   
    "stage": "CHARGEBACK",
    "dueDate": <epoch-timestamp>,
    "createdAt": <epoch-timestamp>,
    "updatedAt": <epoch-timestamp>,   
    "evidences": {
        "explanationLetter": [{
            "evidenceId": "D1",
            "label" : "dummmy"
        }],
        "customerRecallLetter": [],
        "serviceConfirmation":[],
        "refundConfirmation": [],
        "serviceCancellation": [],
        "deliveryProof": [],
        "shippingProof": [],
        "accessActivityLog":[]
    }
}

Response Parameters

Parameter Name	Type	Description
`merchantId`	String	Unique `MerchantID` assigned to the merchant by PhonePe Note: merchantId length will be less than 38 characters.
`disputeId`	String	Unique DisputeId assigned to a dispute
`merchantOrderId`	String	Unique merchant order id generated by merchant
`orderId`	String	PhonePe generated order Id
`transactionId`	String	Unique transaction id generated by phonepe
`transactionCompletedAt`	Long	Epoch timestamp of the transaction completion time (in milliseconds)
`transactionAmount`	Long	Amount of the transaction
`disputeAmount`	Long	Amount for which dispute is raised, will be lesser than or equal to transactionAmount
`refundAmount`	Long	After the status of dispute moved to LOST or WON, The amount that is given back to the customer
`contestAmount`	Long	Amount for which merchant does the contest
`status`	Enum	Status of the dispute Note: The value could be “ACTION_REQUIRED”, “UNDER_REVIEW”, “WON” or “LOST”
`stage`	Enum	Stage of the dispute Note: The value could be “CHARGEBACK” or “PRE_ARBITRATION”
`dueDate`	Long	Epoch timestamp the last date to respond for a dispute for merchant (in milliseconds)
`createdAt`	Long	Epoch timestamp, Creation date of the dispute (in milliseconds)
`updatedAt`	Long	Epoch timestamp, Last updated date of a dispute (in milliseconds)
`evidences`	Object	Map of String and List containing the type as key and List of evidence object as value that merchant uploaded by upload evidence api

Error Scenarios

Error Scenario	Response Code	Response
Dispute not found	404	{ “message”: “Dispute Not Found”, “code”: “DISPUTE_NOT_FOUND” }
When you are contesting again or you have accepted the dispute than contesting it	409	{ “message”: “Transition not allowed”, “code”: “INVALID_TRANSITION” }
Any issue at PhonePe end	500	{ “message”: “Something went wrong, please try again”, “code”: “SOMETHING_WENT_WRONG” }