Skip to main content
POST
/
v2
/
issuer
/
cases
Create a case
curl --request POST \
  --url https://api.decisionly.com/v2/issuer/cases \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cardholder": {
    "billing_address": {
      "city": "San Francisco",
      "country": "US",
      "line1": "742 Evergreen Terrace",
      "line2": "Unit 5B",
      "postal_code": "94102",
      "state": "CA"
    },
    "email": "susie@example.com",
    "issuer_id": "9529456289",
    "name": "Susie Chargeback",
    "type": "individual"
  },
  "custom_fields": {
    "card_program": "CardHub",
    "wallet_type": "mobile"
  },
  "dispute": {
    "amount": 299,
    "currency": "USD",
    "date": "2026-03-15T13:12:18.198-08:00",
    "raised_by": "cardholder",
    "reason": "product_not_received"
  },
  "issuer_evidence": {
    "cardholder_explanation": "I never received this order"
  },
  "merchant": {
    "category_code": "5734",
    "issuer_id": "8201132789",
    "name": "FoodHub"
  },
  "transaction": {
    "amount": 299,
    "arn": "48162855246353338636162",
    "card": {
      "expiry_month": 6,
      "expiry_year": 2028,
      "issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
      "last4": "4242",
      "network": "mastercard",
      "type": "credit"
    },
    "currency": "USD",
    "date": "2026-03-15T13:12:18.198-08:00",
    "issuer_id": "85cfda4d06b8440db3ec15af04061c98",
    "network_details": {
      "mastercard": {
        "switch_serial_number": "242025095"
      }
    }
  }
}
'
{ "cardholder": { "billing_address": { "city": "San Francisco", "country": "US", "line1": "742 Evergreen Terrace", "line2": "Unit 5B", "postal_code": "94102", "state": "CA" }, "email": "susie@example.com", "issuer_id": "9529456289", "name": "Susie Chargeback", "type": "individual" }, "case_id": "case_abc123", "chargeback_due_date": "2026-07-01T00:00:00.000Z", "claim_id": null, "created": "2026-04-01T00:00:00.000Z", "dispute": { "amount": 299, "currency": "USD", "date": "2026-03-15T13:12:18.198-08:00", "raised_by": "cardholder", "reason": "product_not_received" }, "merchant": { "category_code": "5734", "name": "FoodHub" }, "review_status": null, "status": "created", "transaction": { "amount": 299, "arn": "48162855246353338636162", "card": { "expiry_month": 6, "expiry_year": 2028, "last4": "4242", "network": "mastercard" }, "currency": "USD", "date": "2026-03-15T13:12:18.198-08:00" } }

Authorizations

​
Authorization
string
header
required

Use your API key as the username. No password is 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.

​
transaction
object
required

Details of the disputed transaction. Either arn or network_details are 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"

​
reason
enum<string>
deprecated

Deprecated. Use dispute.reason instead.

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"

Response

Returns the newly created 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:

"2026-04-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>
deprecated

Deprecated. Use dispute.reason instead.

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"

​
resolution_due_date
string<date-time> | null

The deadline by which the case must be resolved. Read-only. ISO 8601 format.

Example:

"2026-07-01T00:00:00.000Z"

​
status
enum<string>

The status of the case.

Available options:
created,
chargeback_filed,
chargeback_represented,
prearb_received,
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 network_details are required.