Create a claim with cases

Creates a new claim and all its cases in a single request.

POST /v2/issuer/new_claim

Create a claim with cases

cURL

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": "[e-mail]",
    "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"
}
'

201

Example

{ "cases": [ { "cardholder": { "billing_address": { "city": "San Francisco", "country": "US", "line1": "742 Evergreen Terrace", "line2": "Unit 5B", "postal_code": "94102", "state": "CA" }, "email": "[e-mail]", "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": "[e-mail]", "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

Show child attributes

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).

Show child attributes

cardholder · object

Details of the cardholder.

Show child attributes

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.

Show child attributes

issuer_evidence · object

Issuer evidence for the dispute.

Show child attributes

Response

201

application/json

Returns the newly created claim with all created cases.

cases · object[]

All cases associated with this claim.

Show child attributes

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"