Skip to main content

Update a Dispute

Suggest Edits

Overview​

Update the tags (metadata) of an existing dispute. Tags are key-value pairs that can be used to store additional information about a dispute for tracking and reference purposes.

Resource Access​

Production (api.ahrvo.network)

PUT https://api.ahrvo.network/payments/na/disputes/\{dispute_id}

Staging (gateway.ahrvo.network)

PUT http://gateway.ahrvo.network/payments/na/disputes/\{dispute_id}

Arguments​

AttributeMandatory / OptionalDescription
dispute_idMandatoryThe unique ID of the dispute to update
Finix-VersionMandatorySpecify the API version (e.g., 2022-02-01)
tagsMandatoryKey-value pairs of metadata to attach to the dispute

Example Request​

curl -X PUT https://gateway.ahrvo.network/payments/na/disputes/DPxxxxxxxxxxxxxxxxxx \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic <base64_encoded_credentials>" \
  -H "Finix-Version: 2022-02-01" \
  -d '{
    "tags": {
      "order_number": "41BFASJSAKAS",
      "customer_id": "CUST-98765",
      "internal_note": "Customer contacted support"
    }
  }'

Example Response​

{
  "id": "DPxxxxxxxxxxxxxxxxxx",
  "created_at": "2025-12-08T14:30:00Z",
  "updated_at": "2025-12-10T11:45:00Z",
  "amount": 50000,
  "transfer": "TRxxxxxxxxxxxxxxxxxx",
  "reason": "FRAUD",
  "respond_by": "2025-12-22T23:59:59Z",
  "state": "PENDING",
  "response_state": "NEEDS_RESPONSE",
  "evidence_submitted": "CHARGEBACK",
  "tags": {
    "order_number": "41BFASJSAKAS",
    "customer_id": "CUST-98765",
    "internal_note": "Customer contacted support"
  },
  "_links": {
    "self": {
      "href": "https://api.ahrvo.network/payments/na/disputes/DPxxxxxxxxxxxxxxxxxx"
    },
    "transfer": {
      "href": "https://api.ahrvo.network/payments/na/transfers/TRxxxxxxxxxxxxxxxxxx"
    }
  }
}

API Documentation​