Skip to main content
PUT
/
v1
/
issuer
/
cases
/
{case_id}
Update a case
curl --request PUT \
  --url https://api.decisionly.com/v1/issuer/cases/{case_id} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "invalid_authorization",
  "cardholder": {
    "name": "<string>",
    "email": "jsmith@example.com",
    "issuer_id": "<string>",
    "type": "individual",
    "billing_address": {
      "line1": "742 Evergreen Terrace",
      "line2": "Unit 5B",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94102",
      "country": "US"
    }
  },
  "merchant": {
    "name": "<string>",
    "category_code": "<string>",
    "issuer_id": "<string>"
  },
  "transaction": {
    "date": "2023-11-07T05:31:56Z",
    "amount": 2,
    "currency": "<string>",
    "card_network": "visa",
    "card_last4": "<string>",
    "card_expiry_month": 6,
    "card_expiry_year": 123,
    "card_type": "credit",
    "arn": "<string>",
    "switch_serial_number": "<string>",
    "issuer_id": "<string>",
    "system": "single_message"
  },
  "dispute": {
    "date": "2023-11-07T05:31:56Z",
    "amount": 123,
    "currency": "<string>"
  },
  "issuer_evidence": {
    "documentation": [
      "<string>"
    ],
    "refund": {
      "promise_date": "2023-11-07T05:31:56Z",
      "policy_provided": true,
      "description": "<string>",
      "promised": true
    },
    "product": {
      "order_id": "<string>",
      "description": "<string>",
      "condition": "<string>",
      "type": "merchandise",
      "delivery_date": "2023-11-07T05:31:56Z",
      "expected_delivery_date": "2023-11-07T05:31:56Z"
    },
    "card": {
      "lost_date": "2023-11-07T05:31:56Z",
      "cardholder_has_possession": true,
      "possession_at_transaction": "possessed",
      "active": true
    },
    "fraud": {
      "was_reported": true,
      "submit_report": true
    },
    "prior_transaction": {
      "arn": "<string>",
      "switch_serial_number": "<string>",
      "issuer_id": "<string>",
      "date": "2023-11-07T05:31:56Z",
      "amount": 123,
      "currency": "<string>",
      "system": "single_message",
      "card_network": "visa",
      "card_type": "credit",
      "card_last4": "<string>",
      "card_expiry_month": 6,
      "card_expiry_year": 123,
      "card_fingerprint": "<string>"
    },
    "correct_amount": 123,
    "correct_currency": "<string>",
    "service_end_date": "2023-11-07T05:31:56Z",
    "resolution": {
      "contact_was_attempted": true,
      "contact_date": "2023-11-07T05:31:56Z",
      "contact_success": true,
      "contact_description": "<string>",
      "contact_prohibited_description": "<string>",
      "return_was_attempted": true,
      "return_date": "2023-11-07T05:31:56Z",
      "return_success": true,
      "return_shipping_carrier": "<string>",
      "return_shipping_tracking": "<string>",
      "return_description": "<string>",
      "cancellation_id": "<string>",
      "cancellation_date": "2023-11-07T05:31:56Z",
      "cancellation_description": "<string>"
    },
    "cardholder_message": "<string>",
    "explanation": "<string>"
  },
  "custom_fields": {},
  "file": "auto"
}
'
{
  "case_id": "<string>",
  "program_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "created",
  "closed_reason": "accepted",
  "created": "2023-11-07T05:31:56Z",
  "reason": "<string>",
  "cardholder": {
    "name": "<string>",
    "email": "jsmith@example.com",
    "issuer_id": "<string>",
    "type": "individual",
    "billing_address": {
      "line1": "742 Evergreen Terrace",
      "line2": "Unit 5B",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94102",
      "country": "US"
    }
  },
  "merchant": {
    "name": "<string>",
    "category_code": "<string>",
    "issuer_id": "<string>"
  },
  "transaction": {
    "date": "2023-11-07T05:31:56Z",
    "amount": 2,
    "currency": "<string>",
    "card_network": "visa",
    "card_last4": "<string>",
    "card_expiry_month": 6,
    "card_expiry_year": 123,
    "card_type": "credit",
    "arn": "<string>",
    "switch_serial_number": "<string>",
    "issuer_id": "<string>",
    "system": "single_message"
  },
  "dispute": {
    "date": "2023-11-07T05:31:56Z",
    "amount": 123,
    "currency": "<string>"
  },
  "issuer_evidence": {
    "documentation": [
      "<string>"
    ],
    "refund": {
      "promise_date": "2023-11-07T05:31:56Z",
      "policy_provided": true,
      "description": "<string>",
      "promised": true
    },
    "product": {
      "order_id": "<string>",
      "description": "<string>",
      "condition": "<string>",
      "type": "merchandise",
      "delivery_date": "2023-11-07T05:31:56Z",
      "expected_delivery_date": "2023-11-07T05:31:56Z"
    },
    "card": {
      "lost_date": "2023-11-07T05:31:56Z",
      "cardholder_has_possession": true,
      "possession_at_transaction": "possessed",
      "active": true
    },
    "fraud": {
      "was_reported": true,
      "submit_report": true
    },
    "prior_transaction": {
      "arn": "<string>",
      "switch_serial_number": "<string>",
      "issuer_id": "<string>",
      "date": "2023-11-07T05:31:56Z",
      "amount": 123,
      "currency": "<string>",
      "system": "single_message",
      "card_network": "visa",
      "card_type": "credit",
      "card_last4": "<string>",
      "card_expiry_month": 6,
      "card_expiry_year": 123,
      "card_fingerprint": "<string>"
    },
    "correct_amount": 123,
    "correct_currency": "<string>",
    "service_end_date": "2023-11-07T05:31:56Z",
    "resolution": {
      "contact_was_attempted": true,
      "contact_date": "2023-11-07T05:31:56Z",
      "contact_success": true,
      "contact_description": "<string>",
      "contact_prohibited_description": "<string>",
      "return_was_attempted": true,
      "return_date": "2023-11-07T05:31:56Z",
      "return_success": true,
      "return_shipping_carrier": "<string>",
      "return_shipping_tracking": "<string>",
      "return_description": "<string>",
      "cancellation_id": "<string>",
      "cancellation_date": "2023-11-07T05:31:56Z",
      "cancellation_description": "<string>"
    },
    "cardholder_message": "<string>",
    "explanation": "<string>"
  },
  "custom_fields": {}
}

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
​
reason
enum<string>

The reason for the dispute.

Available options:
invalid_authorization,
fraud,
product_not_received,
product_unacceptable,
not_as_described,
credit_not_processed,
duplicate,
incorrect_amount,
canceled_recurring,
other
​
cardholder
object
​
merchant
object
​
transaction
object

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

​
dispute
object
​
issuer_evidence
object
​
custom_fields
object

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

​
file
enum<string> | null

Filing mode. Use 'auto' to evaluate workflow rules, or 'chargeback' to file immediately.

Available options:
auto,
chargeback

Response

200 - application/json

Returns the updated case.

​
case_id
string

Unique identifier for the case.

Maximum string length: 126
​
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"

​
status
enum<string>

Current status of the case.

Available options:
created,
chargeback_filed,
chargeback_represented,
prearb_filed,
prearb_rebutted,
arbitration_filed,
won,
lost,
closed
​
closed_reason
enum<string> | null

Reason the case was closed, if applicable.

Available options:
accepted,
rejected,
expired,
withdrawn,
merchant_credited
​
created
string<date-time>

When the case was created.

​
reason
string

The reason for the dispute.

​
cardholder
object
​
merchant
object
​
transaction
object

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

​
dispute
object
​
issuer_evidence
object
​
custom_fields
object

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