Skip to main content
POST
/
v2
/
issuer
/
new_claim
Create a claim with cases
curl --request POST \
  --url https://api.decisionly.com/v2/issuer/new_claim \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "card": {
    "expiry_month": 12,
    "expiry_year": 2028,
    "last4": "4242",
    "network": "mastercard",
    "type": "credit"
  },
  "cardholder": {
    "billing_address": {
      "city": "San Francisco",
      "country": "US",
      "line1": "742 Evergreen Terrace",
      "line2": "Unit 5B",
      "postal_code": "94102",
      "state": "CA"
    },
    "email": "jane@example.com",
    "name": "Jane Smith",
    "type": "individual"
  },
  "cases": [
    {
      "case_id": "case_abc123",
      "dispute": {
        "amount": 5000,
        "currency": "USD"
      },
      "merchant": {
        "category_code": "5812",
        "name": "Example Merchant 1"
      },
      "transaction": {
        "amount": 5000,
        "arn": "12345678901234567890123",
        "currency": "USD",
        "date": "2025-01-15T00:00:00.000Z",
        "system": "dual_message"
      }
    },
    {
      "case_id": "case_def456",
      "dispute": {
        "amount": 3000,
        "currency": "USD"
      },
      "merchant": {
        "category_code": "5812",
        "name": "Example Merchant 2"
      },
      "transaction": {
        "amount": 3000,
        "arn": "98765432109876543210987",
        "currency": "USD",
        "date": "2025-01-16T00:00:00.000Z",
        "system": "dual_message"
      }
    }
  ],
  "claim_id": "claim_abc123",
  "dispute": {
    "date": "2025-01-15T00:00:00.000Z",
    "raised_by": "cardholder"
  },
  "issuer_evidence": {
    "cardholder_explanation": "I did not authorize these transactions",
    "documentation": [
      "file_abc123",
      "file_def456"
    ]
  },
  "reason": "fraud"
}
'
{
  "cases": [
    {
      "cardholder": {
        "billing_address": {
          "city": "San Francisco",
          "country": "US",
          "line1": "742 Evergreen Terrace",
          "line2": "Unit 5B",
          "postal_code": "94102",
          "state": "CA"
        },
        "email": "jane@example.com",
        "name": "Jane Smith",
        "type": "individual"
      },
      "case_id": "case_abc123",
      "claim_id": "claim_abc123",
      "closed_reason": null,
      "created": "2025-02-01T00:00:00.000Z",
      "dispute": {
        "amount": 5000,
        "currency": "USD",
        "date": "2025-01-15T00:00:00.000Z",
        "raised_by": "cardholder"
      },
      "issuer_evidence": {
        "cardholder_explanation": "I did not authorize these transactions",
        "documentation": [
          "file_abc123",
          "file_def456"
        ]
      },
      "merchant": {
        "category_code": "5812",
        "name": "Example Merchant 1"
      },
      "reason": "fraud",
      "status": "created",
      "transaction": {
        "amount": 5000,
        "arn": "12345678901234567890123",
        "card": {
          "expiry_month": 12,
          "expiry_year": 2028,
          "last4": "4242",
          "network": "mastercard",
          "type": "credit"
        },
        "currency": "USD",
        "date": "2025-01-15T00:00:00.000Z",
        "system": "dual_message"
      }
    },
    {
      "cardholder": {
        "billing_address": {
          "city": "San Francisco",
          "country": "US",
          "line1": "742 Evergreen Terrace",
          "line2": "Unit 5B",
          "postal_code": "94102",
          "state": "CA"
        },
        "email": "jane@example.com",
        "name": "Jane Smith",
        "type": "individual"
      },
      "case_id": "case_def456",
      "claim_id": "claim_abc123",
      "closed_reason": null,
      "created": "2025-02-01T00:00:00.000Z",
      "dispute": {
        "amount": 3000,
        "currency": "USD",
        "date": "2025-01-15T00:00:00.000Z",
        "raised_by": "cardholder"
      },
      "issuer_evidence": {
        "cardholder_explanation": "I did not authorize these transactions",
        "documentation": [
          "file_abc123",
          "file_def456"
        ]
      },
      "merchant": {
        "category_code": "5812",
        "name": "Example Merchant 2"
      },
      "reason": "fraud",
      "status": "created",
      "transaction": {
        "amount": 3000,
        "arn": "98765432109876543210987",
        "card": {
          "expiry_month": 12,
          "expiry_year": 2028,
          "last4": "4242",
          "network": "mastercard",
          "type": "credit"
        },
        "currency": "USD",
        "date": "2025-01-16T00:00:00.000Z",
        "system": "dual_message"
      }
    }
  ],
  "claim_id": "claim_abc123",
  "created": "2025-02-01T00:00:00.000Z",
  "status": "open",
  "updated": "2025-02-01T00:00:00.000Z"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
cases
object[]
required

Array of cases to create (1-35 items). Each case requires the same transaction fields as creating a case individually.

Required array length: 1 - 35 elements
​
reason
enum<string>
required

Dispute reason (applies to all cases in the claim).

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"

​
card
object

Card information (shared across all cases).

​
cardholder
object

Details of the cardholder.

​
claim_id
string | null

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

Maximum string length: 126
Example:

"claim_abc123"

​
custom_fields
object

Custom fields (shared across all cases).

​
dispute
object

Shared dispute information. The date and raised_by fields are shared across all cases; amount and currency are specified per case.

​
issuer_evidence
object

Issuer evidence for the dispute.

Response

Returns the newly created claim with all created cases.

​
cases
object[]

All cases associated with this claim.

​
claim_id
string

Unique identifier for the claim.

Example:

"claim_abc123"

​
created
string<date-time>

When the claim was created. ISO 8601 format.

Example:

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

​
status
enum<string>

The status of the claim.

Available options:
open,
filed,
closed
Example:

"open"