Retrieve a case

Retrieve a case

curl --request GET \
  --url https://api.decisionly.com/v2/issuer/cases/{case_id} \
  --header 'Authorization: Basic <encoded-value>'

{
  "case_id": "case_abc123",
  "reason": "fraud",
  "cardholder": {
    "name": "Jane Smith",
    "email": "jane@example.com",
    "issuer_id": "9529456289",
    "type": "individual"
  },
  "merchant": {
    "name": "FoodHub",
    "category_code": "5812",
    "issuer_id": "8201132789"
  },
  "transaction": {
    "date": "2025-01-15T00:00:00.000Z",
    "amount": 2990,
    "currency": "USD",
    "card": {
      "network": "visa",
      "last4": "4242",
      "type": "credit",
      "expiry_month": 12,
      "expiry_year": 2028,
      "issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb"
    },
    "arn": "48162855246353338636162",
    "switch_serial_number": "242025095",
    "issuer_id": "85cfda4d06b8440db3ec15af04061c98",
    "system": "dual_message"
  },
  "dispute": {
    "date": "2025-02-01T00:00:00.000Z",
    "amount": 2990,
    "currency": "USD",
    "raised_by": "cardholder"
  },
  "issuer_evidence": {
    "cardholder_explanation": "<string>",
    "issuer_explanation": "<string>",
    "amount_correction": {
      "amount": 123,
      "currency": "<string>"
    },
    "prior_transaction": {
      "arn": "48162855246353338636162",
      "switch_serial_number": "242025095",
      "issuer_id": "85cfda4d06b8440db3ec15af04061c98",
      "date": "2023-11-07T05:31:56Z",
      "amount": 123,
      "currency": "<string>",
      "system": "single_message",
      "card": {
        "network": "visa",
        "last4": "4242",
        "type": "credit",
        "expiry_month": 12,
        "expiry_year": 2028,
        "issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb"
      }
    },
    "merchant_contact": {
      "date": "2023-11-07T05:31:56Z",
      "was_successful": true,
      "description": "<string>",
      "prohibited_reason": "<string>"
    },
    "return": {
      "date": "2023-11-07T05:31:56Z",
      "was_successful": true,
      "description": "<string>",
      "policy_provided": true,
      "shipping": {
        "carrier": "<string>",
        "tracking_number": "<string>"
      }
    },
    "delivery": {
      "date": "2023-11-07T05:31:56Z",
      "expected_date": "2023-11-07T05:31:56Z"
    },
    "service": {
      "end_date": "2023-11-07T05:31:56Z"
    },
    "product": {
      "order_id": "<string>",
      "description": "<string>",
      "condition": "<string>",
      "type": "merchandise"
    },
    "cancellation": {
      "id": "<string>",
      "date": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "policy_provided": true
    },
    "refund": {
      "was_promised": true,
      "promise_date": "2023-11-07T05:31:56Z",
      "description": "<string>"
    },
    "card": {
      "lost_date": "2023-11-07T05:31:56Z",
      "is_active": true,
      "cardholder_has_possession": true,
      "possession_at_transaction": "possessed"
    },
    "documentation": [
      "<string>"
    ]
  },
  "custom_fields": {},
  "status": "created",
  "closed_reason": null,
  "created": "2025-02-01T00:00:00.000Z"
}

GET

issuer

cases

{case_id}

Retrieve a case

curl --request GET \
  --url https://api.decisionly.com/v2/issuer/cases/{case_id} \
  --header 'Authorization: Basic <encoded-value>'

{
  "case_id": "case_abc123",
  "reason": "fraud",
  "cardholder": {
    "name": "Jane Smith",
    "email": "jane@example.com",
    "issuer_id": "9529456289",
    "type": "individual"
  },
  "merchant": {
    "name": "FoodHub",
    "category_code": "5812",
    "issuer_id": "8201132789"
  },
  "transaction": {
    "date": "2025-01-15T00:00:00.000Z",
    "amount": 2990,
    "currency": "USD",
    "card": {
      "network": "visa",
      "last4": "4242",
      "type": "credit",
      "expiry_month": 12,
      "expiry_year": 2028,
      "issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb"
    },
    "arn": "48162855246353338636162",
    "switch_serial_number": "242025095",
    "issuer_id": "85cfda4d06b8440db3ec15af04061c98",
    "system": "dual_message"
  },
  "dispute": {
    "date": "2025-02-01T00:00:00.000Z",
    "amount": 2990,
    "currency": "USD",
    "raised_by": "cardholder"
  },
  "issuer_evidence": {
    "cardholder_explanation": "<string>",
    "issuer_explanation": "<string>",
    "amount_correction": {
      "amount": 123,
      "currency": "<string>"
    },
    "prior_transaction": {
      "arn": "48162855246353338636162",
      "switch_serial_number": "242025095",
      "issuer_id": "85cfda4d06b8440db3ec15af04061c98",
      "date": "2023-11-07T05:31:56Z",
      "amount": 123,
      "currency": "<string>",
      "system": "single_message",
      "card": {
        "network": "visa",
        "last4": "4242",
        "type": "credit",
        "expiry_month": 12,
        "expiry_year": 2028,
        "issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb"
      }
    },
    "merchant_contact": {
      "date": "2023-11-07T05:31:56Z",
      "was_successful": true,
      "description": "<string>",
      "prohibited_reason": "<string>"
    },
    "return": {
      "date": "2023-11-07T05:31:56Z",
      "was_successful": true,
      "description": "<string>",
      "policy_provided": true,
      "shipping": {
        "carrier": "<string>",
        "tracking_number": "<string>"
      }
    },
    "delivery": {
      "date": "2023-11-07T05:31:56Z",
      "expected_date": "2023-11-07T05:31:56Z"
    },
    "service": {
      "end_date": "2023-11-07T05:31:56Z"
    },
    "product": {
      "order_id": "<string>",
      "description": "<string>",
      "condition": "<string>",
      "type": "merchandise"
    },
    "cancellation": {
      "id": "<string>",
      "date": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "policy_provided": true
    },
    "refund": {
      "was_promised": true,
      "promise_date": "2023-11-07T05:31:56Z",
      "description": "<string>"
    },
    "card": {
      "lost_date": "2023-11-07T05:31:56Z",
      "is_active": true,
      "cardholder_has_possession": true,
      "possession_at_transaction": "possessed"
    },
    "documentation": [
      "<string>"
    ]
  },
  "custom_fields": {},
  "status": "created",
  "closed_reason": null,
  "created": "2025-02-01T00:00:00.000Z"
}

Authorizations

Authorization

string

header

required

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

Path Parameters

case_id

string

required

Response

200 - application/json

Returns the case.

case_id

string

Unique identifier for the case.

Example:

"case_abc123"

reason

enum<string>

The reason for the dispute.

Available options:

invalid_authorization,

fraud,

product_not_received,

product_not_as_described,

product_counterfeit,

subscription_canceled,

credit_not_processed,

duplicate_charge,

incorrect_amount,

cash_not_received,

canceled_or_returned,

other

Example:

"fraud"

cardholder

object

Details of the cardholder.

Show child attributes

cardholder.name

string

required

The name of the cardholder.

Maximum string length: 250

Example:

"Jane Smith"

cardholder.email

string<email>

required

The email of the cardholder.

Maximum string length: 320

Example:

"jane@example.com"

cardholder.issuer_id

string | null

Your ID for the cardholder.

Maximum string length: 250

Example:

"9529456289"

cardholder.type

enum<string>

default:individual

The type of cardholder. Defaults to individual.

Available options:

individual,

company

Example:

"individual"

merchant

object

Details of the merchant.

Show child attributes

merchant.name

string

required

The name of the merchant.

Maximum string length: 250

Example:

"FoodHub"

merchant.category_code

string

The category code of the merchant.

Required string length: 4

Example:

"5812"

merchant.issuer_id

string | null

Your ID for the merchant.

Maximum string length: 250

Example:

"8201132789"

transaction

object

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

Show child attributes

transaction.date

string<date-time>

required

Date of the transaction. ISO 8601 format.

Example:

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

transaction.amount

integer

required

Settled amount of the transaction. In the smallest currency unit, such as cents.

Required range: x >= 1

Example:

2990

transaction.currency

string

required

Currency of the transaction amount.

Required string length: 3

Example:

"USD"

transaction.card

object

required

Details of the card used in the disputed transaction(s).

Show child attributes

transaction.card.network

enum<string>

required

The card network.

Available options:

visa,

mastercard,

amex,

discover

Example:

"visa"

transaction.card.last4

string

required

The last four digits of the card.

Example:

"4242"

transaction.card.type

enum<string>

default:credit

The type of card. Defaults to credit.

Available options:

credit,

debit

Example:

"credit"

transaction.card.expiry_month

integer

The expiration month of the card.

Required range: 1 <= x <= 12

Example:

12

transaction.card.expiry_year

integer

The expiration year of the card.

Example:

2028

transaction.card.issuer_id

string | null

Your unique ID for the card (not the PAN).

Maximum string length: 250

Example:

"b5te350d5135ab64a8t3c1097tadetd9ettb"

transaction.arn

string

The acquirer reference number of the transaction. Either this or switch_serial_number is required.

Required string length: 23

Example:

"48162855246353338636162"

transaction.switch_serial_number

string

The switch serial number for the transaction. Either this or arn is required.

Required string length: 9

Example:

"242025095"

transaction.issuer_id

string | null

Your unique ID for the transaction.

Maximum string length: 250

Example:

"85cfda4d06b8440db3ec15af04061c98"

transaction.system

enum<string> | null

The transaction system (single message or dual message).

Available options:

single_message,

dual_message

Example:

"dual_message"

dispute

object

Dispute details for the case.

Show child attributes

dispute.date

string<date-time>

required

When the dispute was raised. ISO 8601 format.

Example:

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

dispute.amount

integer

required

The disputed amount. In the smallest currency unit, such as cents.

Required range: x >= 1

Example:

2990

dispute.currency

string

required

Currency of the disputed amount.

Required string length: 3

Example:

"USD"

dispute.raised_by

enum<string>

default:cardholder

Was the dispute raised by the cardholder or the issuer. Defaults to cardholder.

Available options:

cardholder,

issuer

Example:

"cardholder"

issuer_evidence

object

Issuer evidence for the dispute.

Show child attributes

issuer_evidence.cardholder_explanation

string | null

The complaint of the cardholder.

Maximum string length: 2000

issuer_evidence.issuer_explanation

string | null

A description of the transaction and the dispute.

Maximum string length: 1000

issuer_evidence.amount_correction

object

Corrected transaction amount.

Show child attributes

issuer_evidence.amount_correction.amount

integer

Corrected amount in smallest currency unit.

issuer_evidence.amount_correction.currency

string

Currency code.

Required string length: 3

issuer_evidence.prior_transaction

object

Details of a prior transaction. Can be a full transaction object or partial details.

Show child attributes

issuer_evidence.prior_transaction.arn

string | null

The acquirer reference number of the transaction.

Required string length: 23

Example:

"48162855246353338636162"

issuer_evidence.prior_transaction.switch_serial_number

string | null

The switch serial number for the transaction.

Required string length: 9

Example:

"242025095"

issuer_evidence.prior_transaction.issuer_id

string | null

Your unique ID for the transaction.

Maximum string length: 250

Example:

"85cfda4d06b8440db3ec15af04061c98"

issuer_evidence.prior_transaction.date

string<date-time> | null

Date of the prior transaction.

issuer_evidence.prior_transaction.amount

integer | null

Amount of the prior transaction in smallest currency unit.

issuer_evidence.prior_transaction.currency

string | null

Currency code of the prior transaction.

Required string length: 3

issuer_evidence.prior_transaction.system

enum<string> | null

The transaction system (single message or dual message).

Available options:

single_message,

dual_message

issuer_evidence.prior_transaction.card

object

Details of the card used in the disputed transaction(s).

Show child attributes

issuer_evidence.prior_transaction.card.network

enum<string>

required

The card network.

Available options:

visa,

mastercard,

amex,

discover

Example:

"visa"

issuer_evidence.prior_transaction.card.last4

string

required

The last four digits of the card.

Example:

"4242"

issuer_evidence.prior_transaction.card.type

enum<string>

default:credit

The type of card. Defaults to credit.

Available options:

credit,

debit

Example:

"credit"

issuer_evidence.prior_transaction.card.expiry_month

integer

The expiration month of the card.

Required range: 1 <= x <= 12

Example:

12

issuer_evidence.prior_transaction.card.expiry_year

integer

The expiration year of the card.

Example:

2028

issuer_evidence.prior_transaction.card.issuer_id

string | null

Your unique ID for the card (not the PAN).

Maximum string length: 250

Example:

"b5te350d5135ab64a8t3c1097tadetd9ettb"

issuer_evidence.merchant_contact

object

Details of merchant contact attempt.

Show child attributes

issuer_evidence.merchant_contact.date

string<date-time>

Date of contact attempt.

issuer_evidence.merchant_contact.was_successful

boolean

Whether contact was successful.

issuer_evidence.merchant_contact.description

string | null

Description of the contact attempt.

issuer_evidence.merchant_contact.prohibited_reason

string | null

Reason if contact was prohibited.

issuer_evidence.return

object

Product return details.

Show child attributes

issuer_evidence.return.date

string<date-time>

Date of return.

issuer_evidence.return.was_successful

boolean

Whether return was successful.

issuer_evidence.return.description

string | null

Description of the return.

issuer_evidence.return.policy_provided

boolean | null

Whether return policy was provided.

issuer_evidence.return.shipping

object

Shipping information.

Show child attributes

issuer_evidence.return.shipping.carrier

string

Shipping carrier name.

issuer_evidence.return.shipping.tracking_number

string

Tracking number.

issuer_evidence.delivery

object

Delivery details.

Show child attributes

issuer_evidence.delivery.date

string<date-time> | null

Actual delivery date.

issuer_evidence.delivery.expected_date

string<date-time> | null

Expected delivery date.

issuer_evidence.service

object

Service details.

Show child attributes

issuer_evidence.service.end_date

string<date-time>

Service end date.

issuer_evidence.product

object

Product details.

Show child attributes

issuer_evidence.product.order_id

string | null

Order or invoice ID.

issuer_evidence.product.description

string | null

Product description.

issuer_evidence.product.condition

string | null

Product condition.

issuer_evidence.product.type

enum<string> | null

Type of product.

Available options:

merchandise,

service

issuer_evidence.cancellation

object

Cancellation details.

Show child attributes

issuer_evidence.cancellation.id

string | null

Cancellation ID.

issuer_evidence.cancellation.date

string<date-time> | null

Cancellation date.

issuer_evidence.cancellation.description

string | null

Cancellation description.

issuer_evidence.cancellation.policy_provided

boolean | null

Whether cancellation policy was provided.

issuer_evidence.refund

object

Refund details.

Show child attributes

issuer_evidence.refund.was_promised

boolean | null

Whether refund was promised.

issuer_evidence.refund.promise_date

string<date-time> | null

Date refund was promised.

issuer_evidence.refund.description

string | null

Refund description.

issuer_evidence.card

object

Status of the card, for fraud claims.

Show child attributes

issuer_evidence.card.lost_date

string<date-time> | null

Date card was lost or stolen.

issuer_evidence.card.is_active

boolean | null

Whether card is currently active.

issuer_evidence.card.cardholder_has_possession

boolean | null

Whether cardholder currently has the card.

issuer_evidence.card.possession_at_transaction

enum<string> | null

Card possession status at time of transaction.

Available options:

possessed,

lost,

stolen,

never_received

issuer_evidence.documentation

string[] | null

Array of file IDs for supporting documentation. Upload files using the file upload endpoint.

custom_fields

object

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

status

enum<string>

The status of the case.

Available options:

created,

chargeback_filed,

chargeback_represented,

prearb_filed,

prearb_rebutted,

arbitration_filed,

closed,

won,

lost

Example:

"created"

closed_reason

enum<string> | null

The reason the case was closed.

Available options:

accepted,

rejected,

expired,

withdrawn

Example:

null

created

string<date-time>

When the case was created. ISO 8601 format.

Example:

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

Create a case Update a case

⌘I

v2 Cases

v2 Events

v2 Files

Authorizations

Path Parameters

Response