Update dispute status

Change a dispute's status via an event. After creating a dispute and uploading all necessary forms, reports, and evidence files, send the event OPEN to officially begin the dispute process with the network.

For more information on events and statuses, refer to the Disputes state machine.

This endpoint generates a Dispute status changed event.

Path Params
number
required

Dispute ID

Body Params

Event data.

string
enum
required

Event enums. An event has to occur to change a dispute's status

string
required

Status change reason.

number

Dispute installment ID. If not passed, the first Installment is used.

string
length ≤ 13000

Enter memo pertaining to the case. REQUIRED for ELO dispute. Also REQUIRED when event = SEND_PRE_ARBITRATION and network is Mastercard. Maximum length = 13000 chars.

string
length ≤ 100

Merchant name - 100 characters maximum. REQUIRED only for disputes without transaction and event = SEND_PRE_ARBITRATION and network is Mastercard.

number

Each card network, such as Visa or Mastercard, defines and maintains their own unique set of reason codes, which banks that issue credit and debit cards under their brands apply to disputes. Here's a reason code quick reference for the major credit card networks.

For Visa, this would be either 10 (fraud - card present), 11 (authorization), 12 (processing error), or 13 (consumer dispute).

For more infomation, refer to the Visa or Mastercard chargeback quides.

For example - 4853 (Mastercard - cardholder dispute), 12 (Visa - processing error) or 72 (ELO - denied authorization)

string
length ≤ 1000

Explanation for changing the reason code, if that's what you are doing - 1000 characters maximum. REQUIRED if updated_chargeback_reason_code is passed, event = SEND_PRE_ARBITRATION and network is Mastercard.

boolean

Is pre-arbitration for a partial amount and not the full amount? Used when event = SEND_PRE_ARBITRATION.

string
length ≤ 3

ISO 4217 3-letter currency code, for example, USD (United States) or BRL (Brazilian Real). REQUIRED if pre_arb_is_partial = true and event = SEND_PRE_ARBITRATION.

string
length ≤ 10000

Explanation for asking for full or partial amount - 10000 characters maximum. REQUIRED if pre_arb_is_partial = true or event = DECLINE_PRE_ARBITRATION.

number

Pre-arbitration amount. REQUIRED if pre_arb_is_partial = true and event = SEND_PRE_ARBITRATION.

boolean

Is dispute migrated? Default is false.

Responses

400

Bad Request

401

Unauthorized. Invalid or missing access token.

404

Not found

500

Internal server error

Language
Credentials
Bearer
JWT
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json