Skip to main content
PUT
/
v2
/
issuer
/
cases
/
{case_id}
Update a case
curl --request PUT \
  --url https://api.decisionly.com/v2/issuer/cases/{case_id} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cardholder": {
    "issuer_id": "9529456289",
    "name": "Jane Smith",
    "billing_address": {
      "city": "San Francisco",
      "country": "US",
      "line1": "742 Evergreen Terrace",
      "line2": "Unit 5B",
      "postal_code": "94102",
      "state": "CA"
    },
    "email": "jane@example.com",
    "type": "individual"
  },
  "dispute": {
    "amount": 2990,
    "currency": "USD",
    "date": "2025-02-01T00:00:00.000Z",
    "raised_by": "cardholder"
  },
  "merchant": {
    "name": "FoodHub",
    "category_code": "5812",
    "issuer_id": "8201132789"
  },
  "reason": "fraud",
  "transaction": {
    "amount": 2990,
    "card": {
      "last4": "4242",
      "network": "visa",
      "expiry_month": 12,
      "expiry_year": 2028,
      "issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
      "type": "credit"
    },
    "currency": "USD",
    "date": "2025-01-15T00:00:00.000Z",
    "arn": "48162855246353338636162",
    "issuer_id": "85cfda4d06b8440db3ec15af04061c98",
    "switch_serial_number": "242025095",
    "system": "dual_message"
  },
  "case_id": "case_abc123",
  "custom_fields": {},
  "issuer_evidence": {
    "amount_correction": {
      "amount": 2,
      "currency": "<string>"
    },
    "cancellation": {
      "date": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "id": "<string>",
      "policy_provided": true
    },
    "card": {
      "cardholder_has_possession": true,
      "is_active": true,
      "lost_date": "2023-11-07T05:31:56Z",
      "possession_at_transaction": "possessed"
    },
    "cardholder_explanation": "<string>",
    "delivery": {
      "date": "2023-11-07T05:31:56Z",
      "expected_date": "2023-11-07T05:31:56Z"
    },
    "documentation": [
      "<string>"
    ],
    "fraud": {
      "submit_report": true,
      "was_reported": true
    },
    "issuer_explanation": "<string>",
    "merchant_contact": {
      "date": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "prohibited_reason": "<string>",
      "was_attempted": true,
      "was_successful": true
    },
    "prior_transaction": {
      "amount": 123,
      "arn": "48162855246353338636162",
      "card": {
        "last4": "4242",
        "network": "visa",
        "expiry_month": 12,
        "expiry_year": 2028,
        "issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
        "type": "credit"
      },
      "currency": "<string>",
      "date": "2023-11-07T05:31:56Z",
      "issuer_id": "85cfda4d06b8440db3ec15af04061c98",
      "switch_serial_number": "242025095",
      "system": "single_message"
    },
    "product": {
      "condition": "<string>",
      "description": "<string>",
      "order_id": "<string>",
      "type": "merchandise"
    },
    "refund": {
      "description": "<string>",
      "policy_provided": true,
      "promise_date": "2023-11-07T05:31:56Z",
      "was_promised": true
    },
    "return": {
      "date": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "policy_provided": true,
      "shipping": {
        "carrier": "<string>",
        "tracking_number": "<string>"
      },
      "was_attempted": true,
      "was_successful": true
    },
    "service": {
      "end_date": "2023-11-07T05:31:56Z"
    }
  },
  "program_id": "550e8400-e29b-41d4-a716-446655440000"
}
'
{
  "cardholder": {
    "issuer_id": "9529456289",
    "name": "Jane Smith",
    "billing_address": {
      "city": "San Francisco",
      "country": "US",
      "line1": "742 Evergreen Terrace",
      "line2": "Unit 5B",
      "postal_code": "94102",
      "state": "CA"
    },
    "email": "jane@example.com",
    "type": "individual"
  },
  "case_id": "case_abc123",
  "claim_id": "claim_abc123",
  "created": "2025-02-01T00:00:00.000Z",
  "custom_fields": {},
  "dispute": {
    "amount": 2990,
    "currency": "USD",
    "date": "2025-02-01T00:00:00.000Z",
    "raised_by": "cardholder"
  },
  "issuer_evidence": {
    "amount_correction": {
      "amount": 2,
      "currency": "<string>"
    },
    "cancellation": {
      "date": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "id": "<string>",
      "policy_provided": true
    },
    "card": {
      "cardholder_has_possession": true,
      "is_active": true,
      "lost_date": "2023-11-07T05:31:56Z",
      "possession_at_transaction": "possessed"
    },
    "cardholder_explanation": "<string>",
    "delivery": {
      "date": "2023-11-07T05:31:56Z",
      "expected_date": "2023-11-07T05:31:56Z"
    },
    "documentation": [
      "<string>"
    ],
    "fraud": {
      "submit_report": true,
      "was_reported": true
    },
    "issuer_explanation": "<string>",
    "merchant_contact": {
      "date": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "prohibited_reason": "<string>",
      "was_attempted": true,
      "was_successful": true
    },
    "prior_transaction": {
      "amount": 123,
      "arn": "48162855246353338636162",
      "card": {
        "last4": "4242",
        "network": "visa",
        "expiry_month": 12,
        "expiry_year": 2028,
        "issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
        "type": "credit"
      },
      "currency": "<string>",
      "date": "2023-11-07T05:31:56Z",
      "issuer_id": "85cfda4d06b8440db3ec15af04061c98",
      "switch_serial_number": "242025095",
      "system": "single_message"
    },
    "product": {
      "condition": "<string>",
      "description": "<string>",
      "order_id": "<string>",
      "type": "merchandise"
    },
    "refund": {
      "description": "<string>",
      "policy_provided": true,
      "promise_date": "2023-11-07T05:31:56Z",
      "was_promised": true
    },
    "return": {
      "date": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "policy_provided": true,
      "shipping": {
        "carrier": "<string>",
        "tracking_number": "<string>"
      },
      "was_attempted": true,
      "was_successful": true
    },
    "service": {
      "end_date": "2023-11-07T05:31:56Z"
    }
  },
  "merchant": {
    "name": "FoodHub",
    "category_code": "5812",
    "issuer_id": "8201132789"
  },
  "program_id": "550e8400-e29b-41d4-a716-446655440000",
  "reason": "fraud",
  "status": "created",
  "transaction": {
    "amount": 2990,
    "card": {
      "last4": "4242",
      "network": "visa",
      "expiry_month": 12,
      "expiry_year": 2028,
      "issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
      "type": "credit"
    },
    "currency": "USD",
    "date": "2025-01-15T00:00:00.000Z",
    "arn": "48162855246353338636162",
    "issuer_id": "85cfda4d06b8440db3ec15af04061c98",
    "switch_serial_number": "242025095",
    "system": "dual_message"
  }
}

Authorizations

​
Authorization
string
header
required

Use your API key as the username. No password is required.

Path Parameters

​
case_id
string
required

Body

application/json

Case data for creating a new case.

​
cardholder
object
required

Details of the cardholder.

​
dispute
object
required

Dispute details for the case.

​
merchant
object
required

Details of the merchant.

​
reason
enum<string>
required

The reason for the dispute.

Available options:
canceled_or_returned,
cash_not_received,
credit_not_processed,
duplicate_charge,
fraud,
incorrect_amount,
invalid_authorization,
other,
product_counterfeit,
product_not_as_described,
product_not_received,
subscription_canceled
Example:

"fraud"

​
transaction
object
required

Details of the disputed transaction. Either arn or switch_serial_number is required.

​
case_id
string | null

Optional unique identifier for the case. If not provided, one will be generated automatically.

Maximum string length: 126
Example:

"case_abc123"

​
custom_fields
object

Custom key-value pairs for storing additional data with your cases. See Custom Fields documentation for more details.

​
issuer_evidence
object

Issuer evidence for the dispute.

​
program_id
string | null

Your unique identifier for the card program the case belongs to.

Maximum string length: 126
Example:

"550e8400-e29b-41d4-a716-446655440000"

Response

Returns the updated case.

​
cardholder
object

Details of the cardholder.

​
case_id
string

Unique identifier for the case.

Example:

"case_abc123"

​
claim_id
string | null

The claim this case belongs to. Read-only. Cases are added to claims using the claims API.

Example:

"claim_abc123"

​
created
string<date-time>

When the case was created. ISO 8601 format.

Example:

"2025-02-01T00:00:00.000Z"

​
custom_fields
object

Custom key-value pairs for storing additional data with your cases. See Custom Fields documentation for more details.

​
dispute
object

Dispute details for the case.

​
issuer_evidence
object

Issuer evidence for the dispute.

​
merchant
object

Details of the merchant.

​
program_id
string | null

Your unique identifier for the card program the case belongs to.

Maximum string length: 126
Example:

"550e8400-e29b-41d4-a716-446655440000"

​
reason
enum<string>

The reason for the dispute.

Available options:
canceled_or_returned,
cash_not_received,
credit_not_processed,
duplicate_charge,
fraud,
incorrect_amount,
invalid_authorization,
other,
product_counterfeit,
product_not_as_described,
product_not_received,
subscription_canceled
Example:

"fraud"

​
status
enum<string>

The status of the case.

Available options:
created,
chargeback_filed,
chargeback_represented,
prearb_filed,
prearb_rebutted,
arbitration_filed,
won,
lost,
accepted,
rejected,
expired,
withdrawn,
merchant_credited
Example:

"created"

​
transaction
object

Details of the disputed transaction. Either arn or switch_serial_number is required.