Update submitted associated transactions

PUT////

Update a list of selection forms that have already been submitted for a given dispute case. You can globally set credit_change_reason and auth_change_reason values for all transactions included in the post. These values can be overridden for each associated transaction. Each associated transaction is validated before submitting the batch to the network. If one associated transaction fails validation, the entire request fails. The failure occurs at the first violation and the remaining payload is not validated. The response includes the list of affected associated transactions. If one of the potentially associated transactions has already been submitted to the network, an error is returned. The response provides a list of transactions. Those with the associated field set to true are associated with the case.

URL path parameters

Fields	Description
token string Required	The dispute case token. Allowable Values: 36 char max

Body field details

For a description of the body field details and the fields in the associated_transactions object, see The associated_transactions object.

Update associated transactions response

For a description of the fields in the response, see Associated transactions response. When all associated forms have been updated, a 200 response code is generated with the fields in the response.

Submission errors

Error Code	Description
400	Indicates one of the following has occurred: The user attempted to update the associated transactions of a dispute case that has moved to the `CHARGEBACK_INITIATED` state. (Phase 2) The user attempted to update the associated transactions of a dispute case with a dispute transition that has moved beyond prearbitration. The user attempted to update an associated transaction with a network type that doesn’t match the network type for the dispute. One of the associated transactions has a missing required field.
404	Indicates one of the following has occurred: The dispute case token was not found. One of the associated transactions was not found. The user attempted to update a dispute case that doesn’t belong to the specified program. One of the associated transactions does not belong to the dispute case.

Sample request body

JSON

{
  "network_type": "VISA",
  "credit_change_reason": "66733283294439907772978420740446990478244312974548240509905403454256830653300576453097992718048",
  "auth_change_reason": "6700644900821340007833045221217107468620657600979029382163103999185490",
  "associated_transactions": [
    {
      "associated": true,
      "associated_transaction_token": "string",
      "credit_change_reason": "119335977632844717862380939473877155180707611424947603253800488969535484445104268638719205",
      "auth_change_reason": "21436322989173875475680301320453226327437272571912420748705468"
    }
  ]
}

Sample response body

JSON

{
  "associated_transactions": [
    {
      "network_type": "VISA",
      "token": "string",
      "case_token": "string",
      "network_phase": "DISPUTE",
      "transaction_date": "2022-07-21T20:16:09.353Z",
      "transaction_amount": 0,
      "transaction_currency": "string",
      "merchant_name": "string",
      "network_submission_status": "PENDING",
      "first_network_submission_time": "2022-07-21T20:16:09.353Z",
      "last_network_submission_time": "2022-07-21T20:16:09.353Z",
      "transaction_type": "string",
      "auth_code": "string",
      "network_selection_form": {
        "associated": true,
        "credit_change_reason": "029039246087712053593482311219773792437645087345397147249441224416802068472501671465461",
        "auth_change_reason": "19350516797465538433816692388789084359411154131712658490518433762316944090146"
      }
    }
  ]
}

Getting Started

Testing

Card Issuing

Card Processing

Accounts & Money Movement

Risk, Fraud, and Disputes

Cardholder User Experience

Update submitted associated transactions

URL path parameters

Body field details

Update associated transactions response

Submission errors

Sample request body

Sample response body

​URL path parameters

​Body field details

​Update associated transactions response

​Submission errors

​Sample request body

​Sample response body

URL path parameters

Body field details

Update associated transactions response

Submission errors

Sample request body

Sample response body