PUT /disputes/{id}

Creates or updates (upserts) a dispute with a specified ID.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
amount Number Yes

Dispute amount.

transactionId String Yes

ID of the disputed transaction.

type String Yes

Type of dispute.

Valid values:

  • "arbitration"
  • "bank-return"
  • "forced-refund"
  • "second-chargeback"
  • "inquiry"
  • "verifi-alert"
  • "collaboration"
  • "information-request"
  • "first-chargeback"
  • "ethoca-alert"
  • "fraud"
  • "paypal-claim"
  • "representment"
status String Yes

Status of the dispute.

Valid values:

  • "forfeited"
  • "lost"
  • "won"
  • "under-review"
  • "unknown"
  • "response-needed"
postedTime String Yes

Date and time when the dispute is posted.

caseId String No

Case ID of the dispute.

reasonCode String Yes

Code used in the chargeback that describes the reason for the dispute.

Valid values:

  • "D"
  • "063"
  • "2700"
  • "4903"
  • "4753"
  • "UA21"
  • "2005"
  • "R03"
  • "1000"
  • "79"
  • "4"
  • "54"
  • "42"
  • "debit_not_authorized"
  • "30"
  • "13.4"
  • "12.7"
  • "4752"
  • "CR"
  • "4534"
  • "UA22"
  • "2701"
  • "4902"
  • "UA10"
  • "2713"
  • "7030"
  • "F29"
  • "684"
  • "IN"
  • "062"
  • "not_as_described"
  • "5"
  • "56"
  • "55"
  • "31"
  • "CA"
  • "13.5"
  • "127"
  • "4860"
  • "2710"
  • "2003"
  • "CANCELED_RECURRING_BILLING"
  • "4901"
  • "UA31"
  • "UNAUTHORISED"
  • "6"
  • "57"
  • "13.2"
  • "12.5"
  • "4871"
  • "2002"
  • "A02"
  • "C32"
  • "AP"
  • "MERCHANDISE_OR_SERVICE_NOT_RECEIVED"
  • "004"
  • "2004"
  • "UA32"
  • "UA20"
  • "RN1"
  • "7"
  • "46"
  • "34"
  • "193"
  • "CD"
  • "merchandise"
  • "unauthorized"
  • "pre-chargeback-alert"
  • "13.3"
  • "4870"
  • "12.6"
  • "bank_cannot_process"
  • "C31"
  • "EX"
  • "A01"
  • "F14"
  • "RN2"
  • "product_not_received"
  • "8"
  • "59"
  • "693"
  • "47"
  • "35"
  • "12.3"
  • "customer_initiated"
  • "TNM"
  • "4542"
  • "non_receipt"
  • "TF"
  • "general"
  • "4837"
  • "UA30"
  • "7010"
  • "9"
  • "4849"
  • "SV"
  • "680"
  • "12"
  • "P22"
  • "13.1"
  • "8002"
  • "12.4"
  • "4541"
  • "DUPLICATE_TRANSACTION"
  • "2001"
  • "4553"
  • "4812"
  • "F24"
  • "UA99"
  • "158"
  • "IS"
  • "49"
  • "37"
  • "691"
  • "00"
  • "duplicate"
  • "12.1"
  • "P23"
  • "80"
  • "4859"
  • "024"
  • "C08"
  • "12.2"
  • "93"
  • "IC"
  • "81"
  • "2011"
  • "FR1"
  • "4834"
  • "F10"
  • "4846"
  • "F22"
  • "059"
  • "2708"
  • "11.2"
  • "INCORRECT_AMOUNT"
  • "82"
  • "10.5"
  • "70"
  • "P01"
  • "4586"
  • "4550"
  • "FR2"
  • "C18"
  • "155"
  • "2709"
  • "11.3"
  • "83"
  • "71"
  • "N"
  • "RG"
  • "UA18"
  • "021"
  • "DP1"
  • "UA03"
  • "154"
  • "C05"
  • "2706"
  • "fraudulent"
  • "10.3"
  • "72"
  • "P03"
  • "60"
  • "AW"
  • "FR4"
  • "2870"
  • "special"
  • "F31"
  • "4867"
  • "C04"
  • "4831"
  • "C28"
  • "4855"
  • "unauthorized_claim"
  • "2707"
  • "4908"
  • "11.1"
  • "85"
  • "insufficient_funds"
  • "73"
  • "P"
  • "P04"
  • "10.4"
  • "NA"
  • "F30"
  • "UA28"
  • "2871"
  • "176"
  • "UA01"
  • "incorrect_account_details"
  • "4842"
  • "4854"
  • "MERCHANDISE_OR_SERVICE_NOT_AS_DESCRIBED"
  • "4999"
  • "4866"
  • "2704"
  • "P05"
  • "subscription_canceled"
  • "ITA"
  • "98"
  • "86"
  • "10.1"
  • "74"
  • "0"
  • "62"
  • "50"
  • "FR6"
  • "M10"
  • "13.8"
  • "C14"
  • "credit_not_processed"
  • "C02"
  • "UA02"
  • "CREDIT_NOT_PROCESSED"
  • "175"
  • "A"
  • "4841"
  • "DP"
  • "4853"
  • "4865"
  • "A08"
  • "2705"
  • "LP"
  • "PROBLEM_WITH_REMITTANCE"
  • "10.2"
  • "product_unacceptable"
  • "75"
  • "1"
  • "63"
  • "51"
  • "4840"
  • "NC"
  • "13.9"
  • "UA38"
  • "B"
  • "UA23"
  • "UA11"
  • "2702"
  • "4755"
  • "P07"
  • "4905"
  • "4808"
  • "76"
  • "2"
  • "40"
  • "R13"
  • "13.6"
  • "unrecognized"
  • "12.6.2"
  • "173"
  • "2008"
  • "C"
  • "UA12"
  • "4863"
  • "AL"
  • "2703"
  • "P08"
  • "4904"
  • "4807"
  • "78"
  • "77"
  • "M49"
  • "OTHER"
  • "3"
  • "53"
  • "41"
  • "DA"
  • "M01"
  • "PAYMENT_BY_OTHER_MEANS"
  • "RM"
  • "12.6.1"
  • "13.7"
  • "4850"
currency String Yes

Currency code in ISO 4217 format.

deadlineTime String No

Latest date and time by when a merchant must submit a representment for a dispute. If the deadline is missed, the merchant loses the dispute.

acquirerReferenceNumber String No

Acquirer reference number for the dispute.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.