The Contest Chargeback API allows the merchant to contest the chargeback by providing the appropriate reasons in the request body against the chargeback and merchant ID.
HTTP Method: PATCH
Request parameters
This must contain the header with token you get using the Chargeback Dashboard in the following format:
Generate Token: Use the Chargeback Dashboard to easily generate token in the Chargeback Dashboard. For more information, refer to Generate Token on Chargeback Dashboard.
\--header 'X-Optimus-API-Key: <Bearer token>'Form data
Parameter | Description | Example |
|---|---|---|
chargeback_id
| This parameter must contain the chargeback ID that customer received from PayU. | 1035881 |
merchant_id
| The merchant ID provided to merchant while onboarding. | 2 |
identifier
| The identifier that was received in response when you used the Read Reasons API. For more information, refer to Read Reasons API . | 6f92dad0-4446-4465-bfea-17f587e973d4 |
value
| Dependent on response received from the Read Reasons API, the Value(evidence) to be submitted for contesting the chargeback, for a particular reason code(UUID), image(png ,jpeg/jpg) or file(doc,docx,pdf). Currently, this is not encoded.. For more information, refer to Read Reasons API. |
Sample request
curl --location --globoff --request PATCH 'https://chbuat.payu.in/api/v1/chargebacks/contest' \
--header 'X-Optimus-API-Key: MERCHANT KEY' \
--header 'Content-Type: multipart/form-data' \
--form 'chargeback_id="1035881"' \
--form 'merchant_id="2"' \
--form 'reason_code[0][uuid]="9c2c093c-648a-40b5-8b79-461466578b0c"' \
--form 'reason_code[0][form_data ][0][identifier]="9c2c093c-648a-40b5-8b79-461466578b0c-comments"' \
--form 'reason_code[0][form_data][0][value]="Test Comment"' \
--form 'reason_code[1][uuid]="07b310c2-8c63-4b82-9b87-53a4b963adac"' \
--form 'reason_code[1][form_data][0][identifier]="9b466317-5041-42f9-b6d8-084d5d988465"' \
--form 'reason_code[1][form_data][0][value]="Test Product detail"' \
--form 'reason_code[1][form_data][1][identifier]="c9820d99-f515-4e16-93d2-e5032b454286"' \
--form 'reason_code[1][form_data][1][value]=@"/home/work/Pictures/Screenshot from 2022-06-29 17-33-41.png"'Response parameters
| Parameter | Description |
|---|---|
| id | This parameter contains the chargeback ID. |
| type | The parameter contains the chargeback-details as type. For the list of chargeback types, refer to Chargeback Types . |
| attributes | This parameter contains the chargeback details in a JSON format. For more information, refer to attributes JSON field descriptions. |
attributes JSON field descriptions
| Field | Description | Example |
|---|---|---|
| id | This field contains the chargeback ID. | 1035881 |
| payu-id | The field contains the PayU ID of the merchant. | 15420278029 |
| status | This field contains the status of the chargeback. For the list of chargeback states, refer to Chargeback Status List . | Pending Doc Review |
Sample response
{
"data": {
"id": "1035881",
"type": "chargeback-details",
"attributes": {
"id": 1035881,
"payu-id": "15420278029",
"status": "Pending Doc Review"
}
}
}