Update a dispute

curl --request PATCH \
  --url https://api.synctera.com/v2/disputes/{dispute_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "network_eligibility_override": true
}
'

import requests

url = "https://api.synctera.com/v2/disputes/{dispute_id}"

payload = { "network_eligibility_override": True }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({network_eligibility_override: true})
};

fetch('https://api.synctera.com/v2/disputes/{dispute_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.synctera.com/v2/disputes/{dispute_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'network_eligibility_override' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.synctera.com/v2/disputes/{dispute_id}"

	payload := strings.NewReader("{\n  \"network_eligibility_override\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.synctera.com/v2/disputes/{dispute_id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"network_eligibility_override\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.synctera.com/v2/disputes/{dispute_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"network_eligibility_override\": true\n}"

response = http.request(request)
puts response.read_body

{
  "account_id": "ca4450a5-5d4c-4afc-9533-729e2948c477",
  "creation_time": "2010-05-06T12:23:34.321Z",
  "currency": "USD",
  "customer_id": "52593ea7-4d66-40df-80e9-3b9bc54fa880",
  "date_customer_reported": "2010-05-06T12:23:34.321Z",
  "dispute_documents": [
    {
      "creation_time": "2010-05-06T12:23:34.321Z",
      "dispute_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "file_name": "example.pdf",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "tenant": "abcdef_ghijkl"
    }
  ],
  "disputed_amount": 2,
  "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
  "last_updated_time": "2010-05-06T12:23:34.321Z",
  "memo": "<string>",
  "tenant": "abcdef_ghijkl",
  "transaction_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
  "action_history": [
    {
      "creation_time": "2010-05-06T12:23:34.321Z",
      "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "tenant": "abcdef_ghijkl",
      "amount": 1,
      "external_reference_id": "<string>",
      "memo": "<string>",
      "message": "<string>",
      "supporting_doc_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "updated_reason_code_memo": "<string>"
    }
  ],
  "available_actions": [
    {
      "timestamp_valid_to": "2010-05-06T12:23:34.321Z"
    }
  ],
  "network_eligibility": {
    "is_digital_wallet_token": true,
    "is_network_eligibility_overridden": true,
    "is_three_ds": true
  },
  "external_reference_id": "<string>",
  "timestamp_final_decision": "2023-11-07T05:31:56Z",
  "timestamp_investigation_due": "2023-11-07T05:31:56Z",
  "timestamp_provisional_credit_due": "2023-11-07T05:31:56Z",
  "acquirer_reference_number": "<string>",
  "merchant_contact": {
    "date": "2023-12-25",
    "description": "<string>",
    "prohibited_reason": "<string>",
    "was_attempted": true,
    "was_successful": true
  },
  "switch_serial_number": "<string>"
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "Missing required fields: first_name, dob",
  "status": 400
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "Missing required fields: first_name, dob",
  "status": 400
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "Missing required fields: first_name, dob",
  "status": 400
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "Missing required fields: first_name, dob",
  "status": 400
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "Missing required fields: first_name, dob",
  "status": 400
}

PATCH

disputes

{dispute_id}

Update a dispute

curl --request PATCH \
  --url https://api.synctera.com/v2/disputes/{dispute_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "network_eligibility_override": true
}
'

import requests

url = "https://api.synctera.com/v2/disputes/{dispute_id}"

payload = { "network_eligibility_override": True }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({network_eligibility_override: true})
};

fetch('https://api.synctera.com/v2/disputes/{dispute_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.synctera.com/v2/disputes/{dispute_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'network_eligibility_override' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.synctera.com/v2/disputes/{dispute_id}"

	payload := strings.NewReader("{\n  \"network_eligibility_override\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.synctera.com/v2/disputes/{dispute_id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"network_eligibility_override\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.synctera.com/v2/disputes/{dispute_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"network_eligibility_override\": true\n}"

response = http.request(request)
puts response.read_body

{
  "account_id": "ca4450a5-5d4c-4afc-9533-729e2948c477",
  "creation_time": "2010-05-06T12:23:34.321Z",
  "currency": "USD",
  "customer_id": "52593ea7-4d66-40df-80e9-3b9bc54fa880",
  "date_customer_reported": "2010-05-06T12:23:34.321Z",
  "dispute_documents": [
    {
      "creation_time": "2010-05-06T12:23:34.321Z",
      "dispute_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "file_name": "example.pdf",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "tenant": "abcdef_ghijkl"
    }
  ],
  "disputed_amount": 2,
  "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
  "last_updated_time": "2010-05-06T12:23:34.321Z",
  "memo": "<string>",
  "tenant": "abcdef_ghijkl",
  "transaction_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
  "action_history": [
    {
      "creation_time": "2010-05-06T12:23:34.321Z",
      "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "tenant": "abcdef_ghijkl",
      "amount": 1,
      "external_reference_id": "<string>",
      "memo": "<string>",
      "message": "<string>",
      "supporting_doc_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "updated_reason_code_memo": "<string>"
    }
  ],
  "available_actions": [
    {
      "timestamp_valid_to": "2010-05-06T12:23:34.321Z"
    }
  ],
  "network_eligibility": {
    "is_digital_wallet_token": true,
    "is_network_eligibility_overridden": true,
    "is_three_ds": true
  },
  "external_reference_id": "<string>",
  "timestamp_final_decision": "2023-11-07T05:31:56Z",
  "timestamp_investigation_due": "2023-11-07T05:31:56Z",
  "timestamp_provisional_credit_due": "2023-11-07T05:31:56Z",
  "acquirer_reference_number": "<string>",
  "merchant_contact": {
    "date": "2023-12-25",
    "description": "<string>",
    "prohibited_reason": "<string>",
    "was_attempted": true,
    "was_successful": true
  },
  "switch_serial_number": "<string>"
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "Missing required fields: first_name, dob",
  "status": 400
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "Missing required fields: first_name, dob",
  "status": 400
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "Missing required fields: first_name, dob",
  "status": 400
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "Missing required fields: first_name, dob",
  "status": 400
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "Missing required fields: first_name, dob",
  "status": 400
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

dispute_id

string<uuid>

required

The unique identifier of the dispute

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

Body

application/json

Dispute update request body

network_eligibility_override

boolean

Override network eligibility restrictions and forces the dispute to be filed with the network.

status

enum<string>

The current status of the dispute.

Available options:

OPEN,

CLOSED

Response

Returned dispute

Card Dispute
External Card
ACH Dispute

Response for a card dispute.

account_id

string<uuid>

required

The customer account related to the dispute, to which dispute-related credits will be posted.

Example:

"ca4450a5-5d4c-4afc-9533-729e2948c477"

creation_time

string<date-time>

required

read-only

The timestamp representing when the dispute was created

Example:

"2010-05-06T12:23:34.321Z"

currency

string

required

ISO 4217 Alpha-3 currency code

Required string length: 3

Example:

"USD"

customer_id

string<uuid>

required

The customer related to the dispute, to which dispute-related credits will be posted.

Example:

"52593ea7-4d66-40df-80e9-3b9bc54fa880"

date_customer_reported

string<date-time>

required

The timestamp representing when the customer reported the dispute.

Example:

"2010-05-06T12:23:34.321Z"

decision

enum<string>

required

Decision	Description
LOST	Decision reached in favour of the network.
NONE	No decision was reached.
ONGOING	Dispute is ongoing and requires further action.
RESOLVED	Resolved in favour of the account holder.
WON	Decision reached in favour of the account holder.

Available options:

LOST,

NONE,

ONGOING,

RESOLVED,

WON

dispute_documents

object[]

required

Documents associated with the dispute.

Show child attributes

disputed_amount

integer

required

The amount to be disputed in cents.

Required range: x >= 1

string<uuid>

required

read-only

The unique identifier of the dispute

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

last_updated_time

string<date-time>

required

read-only

The timestamp representing when the dispute was last modified

Example:

"2010-05-06T12:23:34.321Z"

memo

string

required

Brief written message describing the reason for disputing the transaction.

Maximum string length: 1000

network

enum<string>

required

The network with which the transaction was disputed.

Available options:

NONE,

ACH,

DECISIONLY,

MASTERCARD,

MARQETA,

TABAPAY

payment_rail

enum<string>

required

A short string representing the payment rail of the dispute.

Available options:

CARD,

EXTERNAL_CARD,

ACH

status

enum<string>

required

The current status of the dispute.

Available options:

OPEN,

CLOSED

tenant

string

required

The id of the tenant containing the resource.

Example:

"abcdef_ghijkl"

transaction_id

string<uuid>

required

The ID of the posted transaction to be disputed.

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

action_history

Card Action · object[]

required

History of all the action filed for the dispute.

Show child attributes

available_actions

object[]

required

List of actions that can be taken on the dispute.

Show child attributes

credit_status

enum<string>

required

The status of customer account credit related to the dispute

Status	Description
NONE	The customer account has not been credited or a provisional credit has been reversed and not replaced.
PROVISIONAL	A provisional credit has been posted to the customer account.
FINAL	A final credit has been posted to the customer account.

Available options:

NONE,

PROVISIONAL,

FINAL

lifecycle_state

enum<string>

required

Lifecycle	Description
PENDING_ACTION	The dispute has been created and is pending subsequent action.
EVIDENCE_GATHERING	Evidence is being collected before submitting the dispute for evaluation.
EVALUATION	The dispute has been submitted for evaluation.
MANUAL_REVIEW	The dispute requires manual review.
DENIED	The dispute has been denied.
WRITE_OFF	The dispute has been written off and will not be filed with the card network.
CHARGEBACK	A chargeback has been created with the card network. The acquiring bank now has the opportunity to file for re-presentment. If no re-presentment is filed the acquirer assumes financial responsibility and the case is won.
NETWORK_REJECTED_CHARGEBACK	The chargeback submission has been rejected by the card network. The chargeback can be optionally resubmitted once the rejection reason has been addressed.
NETWORK_REJECTED_CHARGEBACK_REVERSAL	The chargeback reversal has been rejected by the card network.
REPRESENTMENT	The acquiring bank has created a re-presentment with the card network. The issuing bank now has the opportunity to file for pre-arbitration. If no pre-arbitration is filed the issuer assumes financial responsibility and the case is lost.
PRE_ARBITRATION	A pre-arbitration case has been created with the network. The acquiring bank now has the opportunity to rebut the case with subsequent evidence. If no rebuttal is filed the acquirer assumes financial responsibility and the case is won.
PRE_ARBITRATION_RESPONSE	The acquiring bank has rebutted the pre-arbitration case. The issuing bank now has the opportunity to file for arbitration. If no arbitration case is filed the issuer assumes financial responsibility and the case is lost.
ARBITRATION	An arbitration case has been created with the card network. The acquiring bank now has the opportunity to rebut the arbitration case with subsequent evidence.
ARBITRATION_RESPONSE	The acquiring bank has rebutted the arbitration case. The issuing bank can either withdraw the case or do nothing and the card network will make a decision on who assumes the financial responsibility.

Available options:

EVIDENCE_GATHERING,

EVALUATION,

MANUAL_REVIEW,

DENIED,

PENDING_ACTION,

WRITE_OFF,

CHARGEBACK,

NETWORK_REJECTED_CHARGEBACK,

NETWORK_REJECTED_CHARGEBACK_REVERSAL,

REPRESENTMENT,

PRE_ARBITRATION,

PRE_ARBITRATION_RESPONSE,

ARBITRATION,

ARBITRATION_RESPONSE

managed_by

enum<string>

required

Managed By	Description
CUSTOMER	The dispute is managed by the customer.
GROUND_CONTROL	The dispute is managed by Synctera Ground Control.
AUTO_WRITE_OFF	The dispute is managed by the automatic write-off workflow.

Available options:

CUSTOMER,

GROUND_CONTROL,

AUTO_WRITE_OFF

network_eligibility

object

required

Network eligibility restrictions.

Show child attributes

reason_code

enum<string>

required

NOTE: deprecated reason codes are accepted for backwards compatibility but will be mapped to their active equivalent reason codes by the API.

Reason Code	Status	Category	Mastercard Code	Documentation Required	Description
NO_CARDHOLDER_AUTHORIZATION	Active	Fraud	4837	No	A fraudulent transaction was made without the cardholder's consent.
QUESTIONABLE_MERCHANT_ACTIVITY	Active	Fraud	4849	No	The merchant is suspected of being involved in fraudulent activities or violating Mastercard rules.
CHIP_LIABILITY_SHIFT	Active	Fraud	4870	No	A counterfeit card was used at a non-EMV-compliant terminal, and the merchant is held liable for the fraudulent transaction.
CHIP_PIN_LIABILITY_SHIFT	Active	Fraud	4871	No	A lost or stolen chip card was used without PIN verification at a terminal that supports PIN, resulting in merchant liability for the fraudulent transaction.
AUTHORIZATION_RELATED_CHARGEBACK	Active	Authorization	4808	No	A transaction was processed without obtaining proper authorization.
POINT_OF_INTERACTION_ERROR	Active	Point-of-Interaction Error	4834	Yes	Processing errors such as ATM withdrawal discrepancies, duplicate transactions, late presentments, and amount discrepancies.
CARDHOLDER_DISPUTE	Active	Cardholder Dispute	4853	Yes	Claims for goods and services not received, counterfeit products, recurring transactions, incomplete transactions, hotel no-show charges, and more.
ATM_CASH_DISPUTE	Deprecated	N/A	N/A	N/A	Some or all funds debited from the cardholder's account as the result of an ATM withdrawal were not dispensed.
CARD_LOST_STOLEN_NEVER_RECEIVED	Deprecated	N/A	N/A	N/A	The cardholder did not authorize the transaction and the card is no longer, or had never been, in the possession of the cardholder.
COUNTERFEIT_GOODS	Deprecated	N/A	N/A	N/A	The cardholder claims that the goods were purported to be genuine, but were counterfeit.
CREDIT_NOT_RECEIVED	Deprecated	N/A	N/A	N/A	The cardholder's account was not credited for a refund from a merchant or was inaccurately debited instead of credited.
DEFECTIVE_GOODS_OR_SERVICES	Deprecated	N/A	N/A	N/A	Goods or services were either not as described or defective, including shipped merchandise was received damaged or not suitable for its intended purpose as well as the merchant didn't honour the terms and conditions of a contract.
DISPUTE_OF_RECURRING_TRANSACTION	Deprecated	N/A	N/A	N/A	The cardholder notified the merchant to cancel the recurring transaction and the merchant continued to bill the cardholder or the cardholder was not aware they were agreeing to a recurring transaction.
DUPLICATE_TRANSACTION	Deprecated	N/A	N/A	N/A	The same transaction has been processed more than once, resulting in duplicate charges.
FRAUDULENT_PROCESSING	Deprecated	N/A	N/A	N/A	The cardholder is in possession and control of all valid cards, processed at least one legitimate face-to-face transaction, and denies making one or more additional face-to-face transactions at the same merchant location.
GOODS_OR_SERVICES_NOT_PROVIDED	Deprecated	N/A	N/A	N/A	The cardholder has been debited for goods or services that were to be shipped, delivered or otherwise provided and were not received by the expected delivery date.
LATE_PRESENTMENT	Deprecated	N/A	N/A	N/A	The transaction was authorized offline by the chip and submitted for clearing more than 7 calendar days after the transaction date.
PAID_BY_OTHER_MEANS	Deprecated	N/A	N/A	N/A	The cardholder used a different form of payment for this specific transaction. (Mastercard pre-compliance/compliance only)
TRANSACTION_AMOUNT_DIFFERS	Deprecated	N/A	N/A	N/A	The amount of the transaction does not match the agreed-upon or expected amount.
TRANSACTION_DID_NOT_COMPLETE	Deprecated	N/A	N/A	N/A	The cardholder engaged in the transaction and claims it did not complete. Goods or services were not provided.
TRANSACTION_NOT_RECOGNIZED	Deprecated	N/A	N/A	N/A	The account holder does not recognize the transaction, possibly due to mistake or fraud.
UNAUTHORIZED_TRANSACTION	Deprecated	N/A	N/A	N/A	The transaction was not authorized by the account holder.

Available options:

CARD_LOST_STOLEN_NEVER_RECEIVED,

FRAUDULENT_PROCESSING,

LATE_PRESENTMENT,

PAID_BY_OTHER_MEANS,

TRANSACTION_DID_NOT_COMPLETE,

TRANSACTION_NOT_RECOGNIZED,

UNAUTHORIZED_TRANSACTION,

NO_CARDHOLDER_AUTHORIZATION,

QUESTIONABLE_MERCHANT_ACTIVITY,

CHIP_LIABILITY_SHIFT,

CHIP_PIN_LIABILITY_SHIFT,

POINT_OF_INTERACTION_ERROR,

FRAUD,

AUTHORIZATION_RELATED_CHARGEBACK,

GOODS_OR_SERVICES_NOT_PROVIDED,

DEFECTIVE_GOODS_OR_SERVICES,

CREDIT_NOT_RECEIVED,

DISPUTE_OF_RECURRING_TRANSACTION,

DUPLICATE_TRANSACTION,

TRANSACTION_AMOUNT_DIFFERS,

ATM_CASH_DISPUTE,

CANCELED_OR_RETURNED,

COUNTERFEIT_GOODS,

CARDHOLDER_DISPUTE

applicable_regulation

enum<string>

Available options:

REGULATION_E,

REGULATION_Z

external_reference_id

string

Reference ID associated with the dispute on the external network.

last_action_by

enum<string>

action_by	Description
INITIATOR	The last action was taken by the initiator of the dispute.
NETWORK	The last action was taken by the network.

Available options:

NETWORK,

INITIATOR

timestamp_final_decision

string<date-time>

The time that a final decision was made on the dispute.

timestamp_investigation_due

string<date-time>

timestamp_provisional_credit_due

string<date-time>

The time by which provisional credit should be posted to the customer account in response to the dispute.

acquirer_reference_number

string

The acquirer reference number of the original transaction associated with the dispute.

merchant_contact

object

Details of a cardholder attempt to contact the merchant about the disputed transaction.

Show child attributes

switch_serial_number

string

The switch serial number of the original transaction associated with the dispute.

Get a Dispute Create a dispute action

⌘I

Synctera API

Customers

Accounts

Cards

Money Movement

Transactions

Platform

Simulations

Update a dispute

Authorizations

Path Parameters

Body

Response