---
updatedAt: 2025-08-07T23:56:31.000Z
agentTools:
  projectIndex: https://docs.vopay.com/llms.txt
---

# dispute-management/challenge

This endpoint allows you to challenge a dispute.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "2.0",
    "title": "Dispute Management Endpoints",
    "description": "The Dispute management API allows you to manage all disputes and chargebacks.",
    "contact": {
      "name": "API Support",
      "email": "help@vopay.com"
    }
  },
  "paths": {
    "/dispute-management/challenge": {
      "post": {
        "description": "This endpoint allows you to challenge a dispute.",
        "summary": "dispute-management/challenge",
        "tags": [
          "Dispute Management Endpoints"
        ],
        "operationId": "DisputeManagementChallengePOST",
        "deprecated": false,
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "Token": {
                    "description": "The token associated with the dispute",
                    "type": "string"
                  },
                  "AccountID": {
                    "description": "Your account ID",
                    "type": "string"
                  },
                  "Key": {
                    "description": "API key for the account",
                    "type": "string"
                  },
                  "Signature": {
                    "description": "Hashed signature for the request",
                    "type": "string"
                  },
                  "DisputeID": {
                    "description": "The ID associated with the dispute",
                    "type": "string"
                  },
                  "Document": {
                    "description": "Base 64 encoded document associated with the dispute",
                    "type": "string"
                  }
                },
                "required": [
                  "Token",
                  "AccountID",
                  "Key",
                  "Signature",
                  "DisputeID",
                  "Document"
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "Success": {
                      "type": "boolean",
                      "description": "True if the request was successful, false if it failed",
                      "example": "true"
                    },
                    "ErrorMessage": {
                      "type": "string",
                      "description": "Contains a description of the error if the request failed",
                      "example": ""
                    },
                    "Dispute": {
                      "type": "object",
                      "description": "A dispute object",
                      "properties": {
                        "0": {
                          "type": "object",
                          "properties": {
                            "DisputeID": {
                              "type": "string",
                              "description": "The ID associated with the dispute",
                              "example": "1"
                            },
                            "DisputeCreatedOn": {
                              "type": "string",
                              "description": "The date and time the dispute was created",
                              "example": "2019-01-01T00:00:00"
                            },
                            "DisputeStatus": {
                              "type": "string",
                              "description": "The status of the dispute",
                              "example": "UnderReview"
                            },
                            "DisputeStage": {
                              "type": "string",
                              "description": "The stage of the dispute",
                              "example": "First Chargeback"
                            },
                            "DisputeAmount": {
                              "type": "number",
                              "description": "The amount of the dispute",
                              "example": "1.00"
                            },
                            "DisputeCurrency": {
                              "type": "string",
                              "description": "The currency of the dispute",
                              "example": "USD"
                            },
                            "DisputeReason": {
                              "type": "string",
                              "description": "The reason for the dispute",
                              "example": "Damaged goods"
                            },
                            "DisputeReasonCode": {
                              "type": "string",
                              "description": "The reason code for the dispute",
                              "example": "1"
                            },
                            "DisputeResult": {
                              "type": "string",
                              "description": "The result of the dispute",
                              "example": "Pending"
                            },
                            "DisputeReplyByDate": {
                              "type": "string",
                              "description": "The date and time the dispute is due for a response",
                              "example": "2019-01-01T00:00:00"
                            },
                            "DaysLeftToRespond": {
                              "type": "number",
                              "description": "The number of days left to respond to the dispute",
                              "example": "1"
                            },
                            "DisputeCardDetails": {
                              "type": "object",
                              "properties": {
                                "DisputeCardBrand": {
                                  "type": "string",
                                  "description": "The brand of the card used for the dispute",
                                  "example": "Visa"
                                },
                                "DisputeCardLast4": {
                                  "type": "string",
                                  "description": "The last 4 digits of the card used for the dispute",
                                  "example": "1234"
                                },
                                "AccountHolderName": {
                                  "type": "string",
                                  "description": "The name of the account holder",
                                  "example": "John Doe"
                                }
                              }
                            },
                            "TransactionDetails": {
                              "type": "object",
                              "properties": {
                                "TransactionID": {
                                  "type": "string",
                                  "description": "The ID associated with the transaction",
                                  "example": "123456789"
                                },
                                "TransactionAmount": {
                                  "type": "number",
                                  "description": "The amount of the transaction",
                                  "example": "1.00"
                                },
                                "TransactionCurrency": {
                                  "type": "string",
                                  "description": "The currency of the transaction",
                                  "example": "USD"
                                },
                                "TransactionDate": {
                                  "type": "string",
                                  "description": "The date and time of the transaction",
                                  "example": "2019-01-01T00:00:00"
                                }
                              }
                            },
                            "DisputeARN": {
                              "type": "string",
                              "description": "The ARN associated with the dispute",
                              "example": "123456789"
                            },
                            "LastUpdatedDate": {
                              "type": "string",
                              "description": "The date and time the dispute was last updated",
                              "example": "2019-01-01T00:00:00"
                            },
                            "Notes": {
                              "type": "object",
                              "description": "An array of notes associated with the dispute",
                              "properties": {
                                "0": {
                                  "type": "object",
                                  "properties": {
                                    "Note": {
                                      "type": "string",
                                      "description": "The note",
                                      "example": "This is a note"
                                    },
                                    "NoteDate": {
                                      "type": "string",
                                      "description": "The date and time the note was created",
                                      "example": "2019-01-01T00:00:00"
                                    }
                                  }
                                }
                              }
                            },
                            "Documents": {
                              "type": "object",
                              "description": "An array of documents associated with the dispute",
                              "properties": {
                                "0": {
                                  "type": "object",
                                  "properties": {
                                    "DocumentID": {
                                      "type": "string",
                                      "description": "The ID associated with the document",
                                      "example": "123456789"
                                    },
                                    "DocumentType": {
                                      "type": "string",
                                      "description": "The type of the document",
                                      "example": "Receipt"
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://earthnode-dev.vopay.com/api/v2"
    }
  ]
}
```