Update a case
curl --request PUT \
--url https://api.decisionly.com/v2/issuer/cases/{case_id} \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"cardholder": {
"issuer_id": "9529456289",
"name": "Jane Smith",
"billing_address": {
"city": "San Francisco",
"country": "US",
"line1": "742 Evergreen Terrace",
"line2": "Unit 5B",
"postal_code": "94102",
"state": "CA"
},
"email": "jane@example.com",
"type": "individual"
},
"dispute": {
"amount": 2990,
"currency": "USD",
"date": "2026-04-01T00:00:00.000Z",
"reason": "fraud",
"raised_by": "cardholder"
},
"merchant": {
"name": "FoodHub",
"category_code": "5812",
"issuer_id": "8201132789"
},
"transaction": {
"amount": 2990,
"arn": "48162855246353338636162",
"card": {
"last4": "4242",
"network": "mastercard",
"billing_cycle_day": 15,
"expiry_month": 12,
"expiry_year": 2028,
"issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
"type": "credit"
},
"currency": "USD",
"date": "2026-03-15T00:00:00.000Z",
"issuer_id": "85cfda4d06b8440db3ec15af04061c98",
"network_details": {
"amex": {
"transaction_id": "<string>",
"electronic_commerce_indicator": "05"
},
"mastercard": {
"switch_serial_number": "<string>"
}
},
"system": "dual_message"
},
"case_id": "case_abc123",
"custom_fields": {},
"issuer_evidence": {
"amount_correction": {
"amount": 2,
"currency": "<string>"
},
"cancellation": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"id": "<string>",
"policy_provided": true
},
"card": {
"cardholder_has_possession": true,
"is_active": true,
"lost_date": "2023-11-07T05:31:56Z"
},
"cardholder_explanation": "<string>",
"delivery": {
"date": "2023-11-07T05:31:56Z",
"expected_date": "2023-11-07T05:31:56Z"
},
"documentation": [
"<string>"
],
"fraud": {
"submit_report": true,
"was_reported": true
},
"issuer_explanation": "<string>",
"merchant_contact": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"prohibited_reason": "<string>",
"was_attempted": true,
"was_successful": true
},
"prior_transaction": {
"amount": 123,
"arn": "48162855246353338636162",
"card": {
"expiry_month": 12,
"expiry_year": 2028,
"issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
"last4": "4242",
"network": "mastercard",
"type": "credit"
},
"currency": "<string>",
"date": "2023-11-07T05:31:56Z",
"issuer_id": "85cfda4d06b8440db3ec15af04061c98"
},
"product": {
"condition": "<string>",
"description": "<string>",
"order_id": "<string>"
},
"refund": {
"description": "<string>",
"policy_provided": true,
"promise_date": "2023-11-07T05:31:56Z",
"was_promised": true
},
"return": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"policy_provided": true,
"shipping": {
"carrier": "<string>",
"tracking_number": "<string>"
},
"was_attempted": true,
"was_successful": true
},
"service": {
"end_date": "2023-11-07T05:31:56Z"
}
},
"program_id": "550e8400-e29b-41d4-a716-446655440000",
"reason": "fraud"
}
'import requests
url = "https://api.decisionly.com/v2/issuer/cases/{case_id}"
payload = {
"cardholder": {
"issuer_id": "9529456289",
"name": "Jane Smith",
"billing_address": {
"city": "San Francisco",
"country": "US",
"line1": "742 Evergreen Terrace",
"line2": "Unit 5B",
"postal_code": "94102",
"state": "CA"
},
"email": "jane@example.com",
"type": "individual"
},
"dispute": {
"amount": 2990,
"currency": "USD",
"date": "2026-04-01T00:00:00.000Z",
"reason": "fraud",
"raised_by": "cardholder"
},
"merchant": {
"name": "FoodHub",
"category_code": "5812",
"issuer_id": "8201132789"
},
"transaction": {
"amount": 2990,
"arn": "48162855246353338636162",
"card": {
"last4": "4242",
"network": "mastercard",
"billing_cycle_day": 15,
"expiry_month": 12,
"expiry_year": 2028,
"issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
"type": "credit"
},
"currency": "USD",
"date": "2026-03-15T00:00:00.000Z",
"issuer_id": "85cfda4d06b8440db3ec15af04061c98",
"network_details": {
"amex": {
"transaction_id": "<string>",
"electronic_commerce_indicator": "05"
},
"mastercard": { "switch_serial_number": "<string>" }
},
"system": "dual_message"
},
"case_id": "case_abc123",
"custom_fields": {},
"issuer_evidence": {
"amount_correction": {
"amount": 2,
"currency": "<string>"
},
"cancellation": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"id": "<string>",
"policy_provided": True
},
"card": {
"cardholder_has_possession": True,
"is_active": True,
"lost_date": "2023-11-07T05:31:56Z"
},
"cardholder_explanation": "<string>",
"delivery": {
"date": "2023-11-07T05:31:56Z",
"expected_date": "2023-11-07T05:31:56Z"
},
"documentation": ["<string>"],
"fraud": {
"submit_report": True,
"was_reported": True
},
"issuer_explanation": "<string>",
"merchant_contact": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"prohibited_reason": "<string>",
"was_attempted": True,
"was_successful": True
},
"prior_transaction": {
"amount": 123,
"arn": "48162855246353338636162",
"card": {
"expiry_month": 12,
"expiry_year": 2028,
"issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
"last4": "4242",
"network": "mastercard",
"type": "credit"
},
"currency": "<string>",
"date": "2023-11-07T05:31:56Z",
"issuer_id": "85cfda4d06b8440db3ec15af04061c98"
},
"product": {
"condition": "<string>",
"description": "<string>",
"order_id": "<string>"
},
"refund": {
"description": "<string>",
"policy_provided": True,
"promise_date": "2023-11-07T05:31:56Z",
"was_promised": True
},
"return": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"policy_provided": True,
"shipping": {
"carrier": "<string>",
"tracking_number": "<string>"
},
"was_attempted": True,
"was_successful": True
},
"service": { "end_date": "2023-11-07T05:31:56Z" }
},
"program_id": "550e8400-e29b-41d4-a716-446655440000",
"reason": "fraud"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
cardholder: {
issuer_id: '9529456289',
name: 'Jane Smith',
billing_address: {
city: 'San Francisco',
country: 'US',
line1: '742 Evergreen Terrace',
line2: 'Unit 5B',
postal_code: '94102',
state: 'CA'
},
email: 'jane@example.com',
type: 'individual'
},
dispute: {
amount: 2990,
currency: 'USD',
date: '2026-04-01T00:00:00.000Z',
reason: 'fraud',
raised_by: 'cardholder'
},
merchant: {name: 'FoodHub', category_code: '5812', issuer_id: '8201132789'},
transaction: {
amount: 2990,
arn: '48162855246353338636162',
card: {
last4: '4242',
network: 'mastercard',
billing_cycle_day: 15,
expiry_month: 12,
expiry_year: 2028,
issuer_id: 'b5te350d5135ab64a8t3c1097tadetd9ettb',
type: 'credit'
},
currency: 'USD',
date: '2026-03-15T00:00:00.000Z',
issuer_id: '85cfda4d06b8440db3ec15af04061c98',
network_details: {
amex: {transaction_id: '<string>', electronic_commerce_indicator: '05'},
mastercard: {switch_serial_number: '<string>'}
},
system: 'dual_message'
},
case_id: 'case_abc123',
custom_fields: {},
issuer_evidence: {
amount_correction: {amount: 2, currency: '<string>'},
cancellation: {
date: '2023-11-07T05:31:56Z',
description: '<string>',
id: '<string>',
policy_provided: true
},
card: {
cardholder_has_possession: true,
is_active: true,
lost_date: '2023-11-07T05:31:56Z'
},
cardholder_explanation: '<string>',
delivery: {date: '2023-11-07T05:31:56Z', expected_date: '2023-11-07T05:31:56Z'},
documentation: ['<string>'],
fraud: {submit_report: true, was_reported: true},
issuer_explanation: '<string>',
merchant_contact: {
date: '2023-11-07T05:31:56Z',
description: '<string>',
prohibited_reason: '<string>',
was_attempted: true,
was_successful: true
},
prior_transaction: {
amount: 123,
arn: '48162855246353338636162',
card: {
expiry_month: 12,
expiry_year: 2028,
issuer_id: 'b5te350d5135ab64a8t3c1097tadetd9ettb',
last4: '4242',
network: 'mastercard',
type: 'credit'
},
currency: '<string>',
date: '2023-11-07T05:31:56Z',
issuer_id: '85cfda4d06b8440db3ec15af04061c98'
},
product: {condition: '<string>', description: '<string>', order_id: '<string>'},
refund: {
description: '<string>',
policy_provided: true,
promise_date: '2023-11-07T05:31:56Z',
was_promised: true
},
return: {
date: '2023-11-07T05:31:56Z',
description: '<string>',
policy_provided: true,
shipping: {carrier: '<string>', tracking_number: '<string>'},
was_attempted: true,
was_successful: true
},
service: {end_date: '2023-11-07T05:31:56Z'}
},
program_id: '550e8400-e29b-41d4-a716-446655440000',
reason: 'fraud'
})
};
fetch('https://api.decisionly.com/v2/issuer/cases/{case_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.decisionly.com/v2/issuer/cases/{case_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'cardholder' => [
'issuer_id' => '9529456289',
'name' => 'Jane Smith',
'billing_address' => [
'city' => 'San Francisco',
'country' => 'US',
'line1' => '742 Evergreen Terrace',
'line2' => 'Unit 5B',
'postal_code' => '94102',
'state' => 'CA'
],
'email' => 'jane@example.com',
'type' => 'individual'
],
'dispute' => [
'amount' => 2990,
'currency' => 'USD',
'date' => '2026-04-01T00:00:00.000Z',
'reason' => 'fraud',
'raised_by' => 'cardholder'
],
'merchant' => [
'name' => 'FoodHub',
'category_code' => '5812',
'issuer_id' => '8201132789'
],
'transaction' => [
'amount' => 2990,
'arn' => '48162855246353338636162',
'card' => [
'last4' => '4242',
'network' => 'mastercard',
'billing_cycle_day' => 15,
'expiry_month' => 12,
'expiry_year' => 2028,
'issuer_id' => 'b5te350d5135ab64a8t3c1097tadetd9ettb',
'type' => 'credit'
],
'currency' => 'USD',
'date' => '2026-03-15T00:00:00.000Z',
'issuer_id' => '85cfda4d06b8440db3ec15af04061c98',
'network_details' => [
'amex' => [
'transaction_id' => '<string>',
'electronic_commerce_indicator' => '05'
],
'mastercard' => [
'switch_serial_number' => '<string>'
]
],
'system' => 'dual_message'
],
'case_id' => 'case_abc123',
'custom_fields' => [
],
'issuer_evidence' => [
'amount_correction' => [
'amount' => 2,
'currency' => '<string>'
],
'cancellation' => [
'date' => '2023-11-07T05:31:56Z',
'description' => '<string>',
'id' => '<string>',
'policy_provided' => true
],
'card' => [
'cardholder_has_possession' => true,
'is_active' => true,
'lost_date' => '2023-11-07T05:31:56Z'
],
'cardholder_explanation' => '<string>',
'delivery' => [
'date' => '2023-11-07T05:31:56Z',
'expected_date' => '2023-11-07T05:31:56Z'
],
'documentation' => [
'<string>'
],
'fraud' => [
'submit_report' => true,
'was_reported' => true
],
'issuer_explanation' => '<string>',
'merchant_contact' => [
'date' => '2023-11-07T05:31:56Z',
'description' => '<string>',
'prohibited_reason' => '<string>',
'was_attempted' => true,
'was_successful' => true
],
'prior_transaction' => [
'amount' => 123,
'arn' => '48162855246353338636162',
'card' => [
'expiry_month' => 12,
'expiry_year' => 2028,
'issuer_id' => 'b5te350d5135ab64a8t3c1097tadetd9ettb',
'last4' => '4242',
'network' => 'mastercard',
'type' => 'credit'
],
'currency' => '<string>',
'date' => '2023-11-07T05:31:56Z',
'issuer_id' => '85cfda4d06b8440db3ec15af04061c98'
],
'product' => [
'condition' => '<string>',
'description' => '<string>',
'order_id' => '<string>'
],
'refund' => [
'description' => '<string>',
'policy_provided' => true,
'promise_date' => '2023-11-07T05:31:56Z',
'was_promised' => true
],
'return' => [
'date' => '2023-11-07T05:31:56Z',
'description' => '<string>',
'policy_provided' => true,
'shipping' => [
'carrier' => '<string>',
'tracking_number' => '<string>'
],
'was_attempted' => true,
'was_successful' => true
],
'service' => [
'end_date' => '2023-11-07T05:31:56Z'
]
],
'program_id' => '550e8400-e29b-41d4-a716-446655440000',
'reason' => 'fraud'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.decisionly.com/v2/issuer/cases/{case_id}"
payload := strings.NewReader("{\n \"cardholder\": {\n \"issuer_id\": \"9529456289\",\n \"name\": \"Jane Smith\",\n \"billing_address\": {\n \"city\": \"San Francisco\",\n \"country\": \"US\",\n \"line1\": \"742 Evergreen Terrace\",\n \"line2\": \"Unit 5B\",\n \"postal_code\": \"94102\",\n \"state\": \"CA\"\n },\n \"email\": \"jane@example.com\",\n \"type\": \"individual\"\n },\n \"dispute\": {\n \"amount\": 2990,\n \"currency\": \"USD\",\n \"date\": \"2026-04-01T00:00:00.000Z\",\n \"reason\": \"fraud\",\n \"raised_by\": \"cardholder\"\n },\n \"merchant\": {\n \"name\": \"FoodHub\",\n \"category_code\": \"5812\",\n \"issuer_id\": \"8201132789\"\n },\n \"transaction\": {\n \"amount\": 2990,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"billing_cycle_day\": 15,\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"type\": \"credit\"\n },\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\",\n \"network_details\": {\n \"amex\": {\n \"transaction_id\": \"<string>\",\n \"electronic_commerce_indicator\": \"05\"\n },\n \"mastercard\": {\n \"switch_serial_number\": \"<string>\"\n }\n },\n \"system\": \"dual_message\"\n },\n \"case_id\": \"case_abc123\",\n \"custom_fields\": {},\n \"issuer_evidence\": {\n \"amount_correction\": {\n \"amount\": 2,\n \"currency\": \"<string>\"\n },\n \"cancellation\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"id\": \"<string>\",\n \"policy_provided\": true\n },\n \"card\": {\n \"cardholder_has_possession\": true,\n \"is_active\": true,\n \"lost_date\": \"2023-11-07T05:31:56Z\"\n },\n \"cardholder_explanation\": \"<string>\",\n \"delivery\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"expected_date\": \"2023-11-07T05:31:56Z\"\n },\n \"documentation\": [\n \"<string>\"\n ],\n \"fraud\": {\n \"submit_report\": true,\n \"was_reported\": true\n },\n \"issuer_explanation\": \"<string>\",\n \"merchant_contact\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"prohibited_reason\": \"<string>\",\n \"was_attempted\": true,\n \"was_successful\": true\n },\n \"prior_transaction\": {\n \"amount\": 123,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\n \"currency\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\"\n },\n \"product\": {\n \"condition\": \"<string>\",\n \"description\": \"<string>\",\n \"order_id\": \"<string>\"\n },\n \"refund\": {\n \"description\": \"<string>\",\n \"policy_provided\": true,\n \"promise_date\": \"2023-11-07T05:31:56Z\",\n \"was_promised\": true\n },\n \"return\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"policy_provided\": true,\n \"shipping\": {\n \"carrier\": \"<string>\",\n \"tracking_number\": \"<string>\"\n },\n \"was_attempted\": true,\n \"was_successful\": true\n },\n \"service\": {\n \"end_date\": \"2023-11-07T05:31:56Z\"\n }\n },\n \"program_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"reason\": \"fraud\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.decisionly.com/v2/issuer/cases/{case_id}")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"cardholder\": {\n \"issuer_id\": \"9529456289\",\n \"name\": \"Jane Smith\",\n \"billing_address\": {\n \"city\": \"San Francisco\",\n \"country\": \"US\",\n \"line1\": \"742 Evergreen Terrace\",\n \"line2\": \"Unit 5B\",\n \"postal_code\": \"94102\",\n \"state\": \"CA\"\n },\n \"email\": \"jane@example.com\",\n \"type\": \"individual\"\n },\n \"dispute\": {\n \"amount\": 2990,\n \"currency\": \"USD\",\n \"date\": \"2026-04-01T00:00:00.000Z\",\n \"reason\": \"fraud\",\n \"raised_by\": \"cardholder\"\n },\n \"merchant\": {\n \"name\": \"FoodHub\",\n \"category_code\": \"5812\",\n \"issuer_id\": \"8201132789\"\n },\n \"transaction\": {\n \"amount\": 2990,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"billing_cycle_day\": 15,\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"type\": \"credit\"\n },\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\",\n \"network_details\": {\n \"amex\": {\n \"transaction_id\": \"<string>\",\n \"electronic_commerce_indicator\": \"05\"\n },\n \"mastercard\": {\n \"switch_serial_number\": \"<string>\"\n }\n },\n \"system\": \"dual_message\"\n },\n \"case_id\": \"case_abc123\",\n \"custom_fields\": {},\n \"issuer_evidence\": {\n \"amount_correction\": {\n \"amount\": 2,\n \"currency\": \"<string>\"\n },\n \"cancellation\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"id\": \"<string>\",\n \"policy_provided\": true\n },\n \"card\": {\n \"cardholder_has_possession\": true,\n \"is_active\": true,\n \"lost_date\": \"2023-11-07T05:31:56Z\"\n },\n \"cardholder_explanation\": \"<string>\",\n \"delivery\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"expected_date\": \"2023-11-07T05:31:56Z\"\n },\n \"documentation\": [\n \"<string>\"\n ],\n \"fraud\": {\n \"submit_report\": true,\n \"was_reported\": true\n },\n \"issuer_explanation\": \"<string>\",\n \"merchant_contact\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"prohibited_reason\": \"<string>\",\n \"was_attempted\": true,\n \"was_successful\": true\n },\n \"prior_transaction\": {\n \"amount\": 123,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\n \"currency\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\"\n },\n \"product\": {\n \"condition\": \"<string>\",\n \"description\": \"<string>\",\n \"order_id\": \"<string>\"\n },\n \"refund\": {\n \"description\": \"<string>\",\n \"policy_provided\": true,\n \"promise_date\": \"2023-11-07T05:31:56Z\",\n \"was_promised\": true\n },\n \"return\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"policy_provided\": true,\n \"shipping\": {\n \"carrier\": \"<string>\",\n \"tracking_number\": \"<string>\"\n },\n \"was_attempted\": true,\n \"was_successful\": true\n },\n \"service\": {\n \"end_date\": \"2023-11-07T05:31:56Z\"\n }\n },\n \"program_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"reason\": \"fraud\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.decisionly.com/v2/issuer/cases/{case_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cardholder\": {\n \"issuer_id\": \"9529456289\",\n \"name\": \"Jane Smith\",\n \"billing_address\": {\n \"city\": \"San Francisco\",\n \"country\": \"US\",\n \"line1\": \"742 Evergreen Terrace\",\n \"line2\": \"Unit 5B\",\n \"postal_code\": \"94102\",\n \"state\": \"CA\"\n },\n \"email\": \"jane@example.com\",\n \"type\": \"individual\"\n },\n \"dispute\": {\n \"amount\": 2990,\n \"currency\": \"USD\",\n \"date\": \"2026-04-01T00:00:00.000Z\",\n \"reason\": \"fraud\",\n \"raised_by\": \"cardholder\"\n },\n \"merchant\": {\n \"name\": \"FoodHub\",\n \"category_code\": \"5812\",\n \"issuer_id\": \"8201132789\"\n },\n \"transaction\": {\n \"amount\": 2990,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"billing_cycle_day\": 15,\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"type\": \"credit\"\n },\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\",\n \"network_details\": {\n \"amex\": {\n \"transaction_id\": \"<string>\",\n \"electronic_commerce_indicator\": \"05\"\n },\n \"mastercard\": {\n \"switch_serial_number\": \"<string>\"\n }\n },\n \"system\": \"dual_message\"\n },\n \"case_id\": \"case_abc123\",\n \"custom_fields\": {},\n \"issuer_evidence\": {\n \"amount_correction\": {\n \"amount\": 2,\n \"currency\": \"<string>\"\n },\n \"cancellation\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"id\": \"<string>\",\n \"policy_provided\": true\n },\n \"card\": {\n \"cardholder_has_possession\": true,\n \"is_active\": true,\n \"lost_date\": \"2023-11-07T05:31:56Z\"\n },\n \"cardholder_explanation\": \"<string>\",\n \"delivery\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"expected_date\": \"2023-11-07T05:31:56Z\"\n },\n \"documentation\": [\n \"<string>\"\n ],\n \"fraud\": {\n \"submit_report\": true,\n \"was_reported\": true\n },\n \"issuer_explanation\": \"<string>\",\n \"merchant_contact\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"prohibited_reason\": \"<string>\",\n \"was_attempted\": true,\n \"was_successful\": true\n },\n \"prior_transaction\": {\n \"amount\": 123,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\n \"currency\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\"\n },\n \"product\": {\n \"condition\": \"<string>\",\n \"description\": \"<string>\",\n \"order_id\": \"<string>\"\n },\n \"refund\": {\n \"description\": \"<string>\",\n \"policy_provided\": true,\n \"promise_date\": \"2023-11-07T05:31:56Z\",\n \"was_promised\": true\n },\n \"return\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"policy_provided\": true,\n \"shipping\": {\n \"carrier\": \"<string>\",\n \"tracking_number\": \"<string>\"\n },\n \"was_attempted\": true,\n \"was_successful\": true\n },\n \"service\": {\n \"end_date\": \"2023-11-07T05:31:56Z\"\n }\n },\n \"program_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"reason\": \"fraud\"\n}"
response = http.request(request)
puts response.read_body{
"cardholder": {
"issuer_id": "9529456289",
"name": "Jane Smith",
"billing_address": {
"city": "San Francisco",
"country": "US",
"line1": "742 Evergreen Terrace",
"line2": "Unit 5B",
"postal_code": "94102",
"state": "CA"
},
"email": "jane@example.com",
"type": "individual"
},
"case_id": "case_abc123",
"claim_id": "claim_abc123",
"created": "2026-04-01T00:00:00.000Z",
"custom_fields": {},
"dispute": {
"amount": 2990,
"currency": "USD",
"date": "2026-04-01T00:00:00.000Z",
"reason": "fraud",
"raised_by": "cardholder"
},
"issuer_evidence": {
"amount_correction": {
"amount": 2,
"currency": "<string>"
},
"cancellation": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"id": "<string>",
"policy_provided": true
},
"card": {
"cardholder_has_possession": true,
"is_active": true,
"lost_date": "2023-11-07T05:31:56Z"
},
"cardholder_explanation": "<string>",
"delivery": {
"date": "2023-11-07T05:31:56Z",
"expected_date": "2023-11-07T05:31:56Z"
},
"documentation": [
"<string>"
],
"fraud": {
"submit_report": true,
"was_reported": true
},
"issuer_explanation": "<string>",
"merchant_contact": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"prohibited_reason": "<string>",
"was_attempted": true,
"was_successful": true
},
"prior_transaction": {
"amount": 123,
"arn": "48162855246353338636162",
"card": {
"expiry_month": 12,
"expiry_year": 2028,
"issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
"last4": "4242",
"network": "mastercard",
"type": "credit"
},
"currency": "<string>",
"date": "2023-11-07T05:31:56Z",
"issuer_id": "85cfda4d06b8440db3ec15af04061c98"
},
"product": {
"condition": "<string>",
"description": "<string>",
"order_id": "<string>"
},
"refund": {
"description": "<string>",
"policy_provided": true,
"promise_date": "2023-11-07T05:31:56Z",
"was_promised": true
},
"return": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"policy_provided": true,
"shipping": {
"carrier": "<string>",
"tracking_number": "<string>"
},
"was_attempted": true,
"was_successful": true
},
"service": {
"end_date": "2023-11-07T05:31:56Z"
}
},
"merchant": {
"name": "FoodHub",
"category_code": "5812",
"issuer_id": "8201132789"
},
"program_id": "550e8400-e29b-41d4-a716-446655440000",
"reason": "fraud",
"resolution_due_date": "2026-07-01T00:00:00.000Z",
"status": "created",
"transaction": {
"amount": 2990,
"arn": "48162855246353338636162",
"card": {
"last4": "4242",
"network": "mastercard",
"billing_cycle_day": 15,
"expiry_month": 12,
"expiry_year": 2028,
"issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
"type": "credit"
},
"currency": "USD",
"date": "2026-03-15T00:00:00.000Z",
"issuer_id": "85cfda4d06b8440db3ec15af04061c98",
"network_details": {
"amex": {
"transaction_id": "<string>",
"electronic_commerce_indicator": "05"
},
"mastercard": {
"switch_serial_number": "<string>"
}
},
"system": "dual_message"
}
}{
"message": "Case has been filed with the card network and cannot be updated."
}v2 Cases
Update a case
Updates a case. Filed cases cannot be updated. Partial updates are supported - you only need to include the fields you want to update in the request body.
PUT
/
v2
/
issuer
/
cases
/
{case_id}
Update a case
curl --request PUT \
--url https://api.decisionly.com/v2/issuer/cases/{case_id} \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"cardholder": {
"issuer_id": "9529456289",
"name": "Jane Smith",
"billing_address": {
"city": "San Francisco",
"country": "US",
"line1": "742 Evergreen Terrace",
"line2": "Unit 5B",
"postal_code": "94102",
"state": "CA"
},
"email": "jane@example.com",
"type": "individual"
},
"dispute": {
"amount": 2990,
"currency": "USD",
"date": "2026-04-01T00:00:00.000Z",
"reason": "fraud",
"raised_by": "cardholder"
},
"merchant": {
"name": "FoodHub",
"category_code": "5812",
"issuer_id": "8201132789"
},
"transaction": {
"amount": 2990,
"arn": "48162855246353338636162",
"card": {
"last4": "4242",
"network": "mastercard",
"billing_cycle_day": 15,
"expiry_month": 12,
"expiry_year": 2028,
"issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
"type": "credit"
},
"currency": "USD",
"date": "2026-03-15T00:00:00.000Z",
"issuer_id": "85cfda4d06b8440db3ec15af04061c98",
"network_details": {
"amex": {
"transaction_id": "<string>",
"electronic_commerce_indicator": "05"
},
"mastercard": {
"switch_serial_number": "<string>"
}
},
"system": "dual_message"
},
"case_id": "case_abc123",
"custom_fields": {},
"issuer_evidence": {
"amount_correction": {
"amount": 2,
"currency": "<string>"
},
"cancellation": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"id": "<string>",
"policy_provided": true
},
"card": {
"cardholder_has_possession": true,
"is_active": true,
"lost_date": "2023-11-07T05:31:56Z"
},
"cardholder_explanation": "<string>",
"delivery": {
"date": "2023-11-07T05:31:56Z",
"expected_date": "2023-11-07T05:31:56Z"
},
"documentation": [
"<string>"
],
"fraud": {
"submit_report": true,
"was_reported": true
},
"issuer_explanation": "<string>",
"merchant_contact": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"prohibited_reason": "<string>",
"was_attempted": true,
"was_successful": true
},
"prior_transaction": {
"amount": 123,
"arn": "48162855246353338636162",
"card": {
"expiry_month": 12,
"expiry_year": 2028,
"issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
"last4": "4242",
"network": "mastercard",
"type": "credit"
},
"currency": "<string>",
"date": "2023-11-07T05:31:56Z",
"issuer_id": "85cfda4d06b8440db3ec15af04061c98"
},
"product": {
"condition": "<string>",
"description": "<string>",
"order_id": "<string>"
},
"refund": {
"description": "<string>",
"policy_provided": true,
"promise_date": "2023-11-07T05:31:56Z",
"was_promised": true
},
"return": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"policy_provided": true,
"shipping": {
"carrier": "<string>",
"tracking_number": "<string>"
},
"was_attempted": true,
"was_successful": true
},
"service": {
"end_date": "2023-11-07T05:31:56Z"
}
},
"program_id": "550e8400-e29b-41d4-a716-446655440000",
"reason": "fraud"
}
'import requests
url = "https://api.decisionly.com/v2/issuer/cases/{case_id}"
payload = {
"cardholder": {
"issuer_id": "9529456289",
"name": "Jane Smith",
"billing_address": {
"city": "San Francisco",
"country": "US",
"line1": "742 Evergreen Terrace",
"line2": "Unit 5B",
"postal_code": "94102",
"state": "CA"
},
"email": "jane@example.com",
"type": "individual"
},
"dispute": {
"amount": 2990,
"currency": "USD",
"date": "2026-04-01T00:00:00.000Z",
"reason": "fraud",
"raised_by": "cardholder"
},
"merchant": {
"name": "FoodHub",
"category_code": "5812",
"issuer_id": "8201132789"
},
"transaction": {
"amount": 2990,
"arn": "48162855246353338636162",
"card": {
"last4": "4242",
"network": "mastercard",
"billing_cycle_day": 15,
"expiry_month": 12,
"expiry_year": 2028,
"issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
"type": "credit"
},
"currency": "USD",
"date": "2026-03-15T00:00:00.000Z",
"issuer_id": "85cfda4d06b8440db3ec15af04061c98",
"network_details": {
"amex": {
"transaction_id": "<string>",
"electronic_commerce_indicator": "05"
},
"mastercard": { "switch_serial_number": "<string>" }
},
"system": "dual_message"
},
"case_id": "case_abc123",
"custom_fields": {},
"issuer_evidence": {
"amount_correction": {
"amount": 2,
"currency": "<string>"
},
"cancellation": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"id": "<string>",
"policy_provided": True
},
"card": {
"cardholder_has_possession": True,
"is_active": True,
"lost_date": "2023-11-07T05:31:56Z"
},
"cardholder_explanation": "<string>",
"delivery": {
"date": "2023-11-07T05:31:56Z",
"expected_date": "2023-11-07T05:31:56Z"
},
"documentation": ["<string>"],
"fraud": {
"submit_report": True,
"was_reported": True
},
"issuer_explanation": "<string>",
"merchant_contact": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"prohibited_reason": "<string>",
"was_attempted": True,
"was_successful": True
},
"prior_transaction": {
"amount": 123,
"arn": "48162855246353338636162",
"card": {
"expiry_month": 12,
"expiry_year": 2028,
"issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
"last4": "4242",
"network": "mastercard",
"type": "credit"
},
"currency": "<string>",
"date": "2023-11-07T05:31:56Z",
"issuer_id": "85cfda4d06b8440db3ec15af04061c98"
},
"product": {
"condition": "<string>",
"description": "<string>",
"order_id": "<string>"
},
"refund": {
"description": "<string>",
"policy_provided": True,
"promise_date": "2023-11-07T05:31:56Z",
"was_promised": True
},
"return": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"policy_provided": True,
"shipping": {
"carrier": "<string>",
"tracking_number": "<string>"
},
"was_attempted": True,
"was_successful": True
},
"service": { "end_date": "2023-11-07T05:31:56Z" }
},
"program_id": "550e8400-e29b-41d4-a716-446655440000",
"reason": "fraud"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
cardholder: {
issuer_id: '9529456289',
name: 'Jane Smith',
billing_address: {
city: 'San Francisco',
country: 'US',
line1: '742 Evergreen Terrace',
line2: 'Unit 5B',
postal_code: '94102',
state: 'CA'
},
email: 'jane@example.com',
type: 'individual'
},
dispute: {
amount: 2990,
currency: 'USD',
date: '2026-04-01T00:00:00.000Z',
reason: 'fraud',
raised_by: 'cardholder'
},
merchant: {name: 'FoodHub', category_code: '5812', issuer_id: '8201132789'},
transaction: {
amount: 2990,
arn: '48162855246353338636162',
card: {
last4: '4242',
network: 'mastercard',
billing_cycle_day: 15,
expiry_month: 12,
expiry_year: 2028,
issuer_id: 'b5te350d5135ab64a8t3c1097tadetd9ettb',
type: 'credit'
},
currency: 'USD',
date: '2026-03-15T00:00:00.000Z',
issuer_id: '85cfda4d06b8440db3ec15af04061c98',
network_details: {
amex: {transaction_id: '<string>', electronic_commerce_indicator: '05'},
mastercard: {switch_serial_number: '<string>'}
},
system: 'dual_message'
},
case_id: 'case_abc123',
custom_fields: {},
issuer_evidence: {
amount_correction: {amount: 2, currency: '<string>'},
cancellation: {
date: '2023-11-07T05:31:56Z',
description: '<string>',
id: '<string>',
policy_provided: true
},
card: {
cardholder_has_possession: true,
is_active: true,
lost_date: '2023-11-07T05:31:56Z'
},
cardholder_explanation: '<string>',
delivery: {date: '2023-11-07T05:31:56Z', expected_date: '2023-11-07T05:31:56Z'},
documentation: ['<string>'],
fraud: {submit_report: true, was_reported: true},
issuer_explanation: '<string>',
merchant_contact: {
date: '2023-11-07T05:31:56Z',
description: '<string>',
prohibited_reason: '<string>',
was_attempted: true,
was_successful: true
},
prior_transaction: {
amount: 123,
arn: '48162855246353338636162',
card: {
expiry_month: 12,
expiry_year: 2028,
issuer_id: 'b5te350d5135ab64a8t3c1097tadetd9ettb',
last4: '4242',
network: 'mastercard',
type: 'credit'
},
currency: '<string>',
date: '2023-11-07T05:31:56Z',
issuer_id: '85cfda4d06b8440db3ec15af04061c98'
},
product: {condition: '<string>', description: '<string>', order_id: '<string>'},
refund: {
description: '<string>',
policy_provided: true,
promise_date: '2023-11-07T05:31:56Z',
was_promised: true
},
return: {
date: '2023-11-07T05:31:56Z',
description: '<string>',
policy_provided: true,
shipping: {carrier: '<string>', tracking_number: '<string>'},
was_attempted: true,
was_successful: true
},
service: {end_date: '2023-11-07T05:31:56Z'}
},
program_id: '550e8400-e29b-41d4-a716-446655440000',
reason: 'fraud'
})
};
fetch('https://api.decisionly.com/v2/issuer/cases/{case_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.decisionly.com/v2/issuer/cases/{case_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'cardholder' => [
'issuer_id' => '9529456289',
'name' => 'Jane Smith',
'billing_address' => [
'city' => 'San Francisco',
'country' => 'US',
'line1' => '742 Evergreen Terrace',
'line2' => 'Unit 5B',
'postal_code' => '94102',
'state' => 'CA'
],
'email' => 'jane@example.com',
'type' => 'individual'
],
'dispute' => [
'amount' => 2990,
'currency' => 'USD',
'date' => '2026-04-01T00:00:00.000Z',
'reason' => 'fraud',
'raised_by' => 'cardholder'
],
'merchant' => [
'name' => 'FoodHub',
'category_code' => '5812',
'issuer_id' => '8201132789'
],
'transaction' => [
'amount' => 2990,
'arn' => '48162855246353338636162',
'card' => [
'last4' => '4242',
'network' => 'mastercard',
'billing_cycle_day' => 15,
'expiry_month' => 12,
'expiry_year' => 2028,
'issuer_id' => 'b5te350d5135ab64a8t3c1097tadetd9ettb',
'type' => 'credit'
],
'currency' => 'USD',
'date' => '2026-03-15T00:00:00.000Z',
'issuer_id' => '85cfda4d06b8440db3ec15af04061c98',
'network_details' => [
'amex' => [
'transaction_id' => '<string>',
'electronic_commerce_indicator' => '05'
],
'mastercard' => [
'switch_serial_number' => '<string>'
]
],
'system' => 'dual_message'
],
'case_id' => 'case_abc123',
'custom_fields' => [
],
'issuer_evidence' => [
'amount_correction' => [
'amount' => 2,
'currency' => '<string>'
],
'cancellation' => [
'date' => '2023-11-07T05:31:56Z',
'description' => '<string>',
'id' => '<string>',
'policy_provided' => true
],
'card' => [
'cardholder_has_possession' => true,
'is_active' => true,
'lost_date' => '2023-11-07T05:31:56Z'
],
'cardholder_explanation' => '<string>',
'delivery' => [
'date' => '2023-11-07T05:31:56Z',
'expected_date' => '2023-11-07T05:31:56Z'
],
'documentation' => [
'<string>'
],
'fraud' => [
'submit_report' => true,
'was_reported' => true
],
'issuer_explanation' => '<string>',
'merchant_contact' => [
'date' => '2023-11-07T05:31:56Z',
'description' => '<string>',
'prohibited_reason' => '<string>',
'was_attempted' => true,
'was_successful' => true
],
'prior_transaction' => [
'amount' => 123,
'arn' => '48162855246353338636162',
'card' => [
'expiry_month' => 12,
'expiry_year' => 2028,
'issuer_id' => 'b5te350d5135ab64a8t3c1097tadetd9ettb',
'last4' => '4242',
'network' => 'mastercard',
'type' => 'credit'
],
'currency' => '<string>',
'date' => '2023-11-07T05:31:56Z',
'issuer_id' => '85cfda4d06b8440db3ec15af04061c98'
],
'product' => [
'condition' => '<string>',
'description' => '<string>',
'order_id' => '<string>'
],
'refund' => [
'description' => '<string>',
'policy_provided' => true,
'promise_date' => '2023-11-07T05:31:56Z',
'was_promised' => true
],
'return' => [
'date' => '2023-11-07T05:31:56Z',
'description' => '<string>',
'policy_provided' => true,
'shipping' => [
'carrier' => '<string>',
'tracking_number' => '<string>'
],
'was_attempted' => true,
'was_successful' => true
],
'service' => [
'end_date' => '2023-11-07T05:31:56Z'
]
],
'program_id' => '550e8400-e29b-41d4-a716-446655440000',
'reason' => 'fraud'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.decisionly.com/v2/issuer/cases/{case_id}"
payload := strings.NewReader("{\n \"cardholder\": {\n \"issuer_id\": \"9529456289\",\n \"name\": \"Jane Smith\",\n \"billing_address\": {\n \"city\": \"San Francisco\",\n \"country\": \"US\",\n \"line1\": \"742 Evergreen Terrace\",\n \"line2\": \"Unit 5B\",\n \"postal_code\": \"94102\",\n \"state\": \"CA\"\n },\n \"email\": \"jane@example.com\",\n \"type\": \"individual\"\n },\n \"dispute\": {\n \"amount\": 2990,\n \"currency\": \"USD\",\n \"date\": \"2026-04-01T00:00:00.000Z\",\n \"reason\": \"fraud\",\n \"raised_by\": \"cardholder\"\n },\n \"merchant\": {\n \"name\": \"FoodHub\",\n \"category_code\": \"5812\",\n \"issuer_id\": \"8201132789\"\n },\n \"transaction\": {\n \"amount\": 2990,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"billing_cycle_day\": 15,\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"type\": \"credit\"\n },\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\",\n \"network_details\": {\n \"amex\": {\n \"transaction_id\": \"<string>\",\n \"electronic_commerce_indicator\": \"05\"\n },\n \"mastercard\": {\n \"switch_serial_number\": \"<string>\"\n }\n },\n \"system\": \"dual_message\"\n },\n \"case_id\": \"case_abc123\",\n \"custom_fields\": {},\n \"issuer_evidence\": {\n \"amount_correction\": {\n \"amount\": 2,\n \"currency\": \"<string>\"\n },\n \"cancellation\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"id\": \"<string>\",\n \"policy_provided\": true\n },\n \"card\": {\n \"cardholder_has_possession\": true,\n \"is_active\": true,\n \"lost_date\": \"2023-11-07T05:31:56Z\"\n },\n \"cardholder_explanation\": \"<string>\",\n \"delivery\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"expected_date\": \"2023-11-07T05:31:56Z\"\n },\n \"documentation\": [\n \"<string>\"\n ],\n \"fraud\": {\n \"submit_report\": true,\n \"was_reported\": true\n },\n \"issuer_explanation\": \"<string>\",\n \"merchant_contact\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"prohibited_reason\": \"<string>\",\n \"was_attempted\": true,\n \"was_successful\": true\n },\n \"prior_transaction\": {\n \"amount\": 123,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\n \"currency\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\"\n },\n \"product\": {\n \"condition\": \"<string>\",\n \"description\": \"<string>\",\n \"order_id\": \"<string>\"\n },\n \"refund\": {\n \"description\": \"<string>\",\n \"policy_provided\": true,\n \"promise_date\": \"2023-11-07T05:31:56Z\",\n \"was_promised\": true\n },\n \"return\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"policy_provided\": true,\n \"shipping\": {\n \"carrier\": \"<string>\",\n \"tracking_number\": \"<string>\"\n },\n \"was_attempted\": true,\n \"was_successful\": true\n },\n \"service\": {\n \"end_date\": \"2023-11-07T05:31:56Z\"\n }\n },\n \"program_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"reason\": \"fraud\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.decisionly.com/v2/issuer/cases/{case_id}")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"cardholder\": {\n \"issuer_id\": \"9529456289\",\n \"name\": \"Jane Smith\",\n \"billing_address\": {\n \"city\": \"San Francisco\",\n \"country\": \"US\",\n \"line1\": \"742 Evergreen Terrace\",\n \"line2\": \"Unit 5B\",\n \"postal_code\": \"94102\",\n \"state\": \"CA\"\n },\n \"email\": \"jane@example.com\",\n \"type\": \"individual\"\n },\n \"dispute\": {\n \"amount\": 2990,\n \"currency\": \"USD\",\n \"date\": \"2026-04-01T00:00:00.000Z\",\n \"reason\": \"fraud\",\n \"raised_by\": \"cardholder\"\n },\n \"merchant\": {\n \"name\": \"FoodHub\",\n \"category_code\": \"5812\",\n \"issuer_id\": \"8201132789\"\n },\n \"transaction\": {\n \"amount\": 2990,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"billing_cycle_day\": 15,\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"type\": \"credit\"\n },\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\",\n \"network_details\": {\n \"amex\": {\n \"transaction_id\": \"<string>\",\n \"electronic_commerce_indicator\": \"05\"\n },\n \"mastercard\": {\n \"switch_serial_number\": \"<string>\"\n }\n },\n \"system\": \"dual_message\"\n },\n \"case_id\": \"case_abc123\",\n \"custom_fields\": {},\n \"issuer_evidence\": {\n \"amount_correction\": {\n \"amount\": 2,\n \"currency\": \"<string>\"\n },\n \"cancellation\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"id\": \"<string>\",\n \"policy_provided\": true\n },\n \"card\": {\n \"cardholder_has_possession\": true,\n \"is_active\": true,\n \"lost_date\": \"2023-11-07T05:31:56Z\"\n },\n \"cardholder_explanation\": \"<string>\",\n \"delivery\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"expected_date\": \"2023-11-07T05:31:56Z\"\n },\n \"documentation\": [\n \"<string>\"\n ],\n \"fraud\": {\n \"submit_report\": true,\n \"was_reported\": true\n },\n \"issuer_explanation\": \"<string>\",\n \"merchant_contact\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"prohibited_reason\": \"<string>\",\n \"was_attempted\": true,\n \"was_successful\": true\n },\n \"prior_transaction\": {\n \"amount\": 123,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\n \"currency\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\"\n },\n \"product\": {\n \"condition\": \"<string>\",\n \"description\": \"<string>\",\n \"order_id\": \"<string>\"\n },\n \"refund\": {\n \"description\": \"<string>\",\n \"policy_provided\": true,\n \"promise_date\": \"2023-11-07T05:31:56Z\",\n \"was_promised\": true\n },\n \"return\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"policy_provided\": true,\n \"shipping\": {\n \"carrier\": \"<string>\",\n \"tracking_number\": \"<string>\"\n },\n \"was_attempted\": true,\n \"was_successful\": true\n },\n \"service\": {\n \"end_date\": \"2023-11-07T05:31:56Z\"\n }\n },\n \"program_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"reason\": \"fraud\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.decisionly.com/v2/issuer/cases/{case_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cardholder\": {\n \"issuer_id\": \"9529456289\",\n \"name\": \"Jane Smith\",\n \"billing_address\": {\n \"city\": \"San Francisco\",\n \"country\": \"US\",\n \"line1\": \"742 Evergreen Terrace\",\n \"line2\": \"Unit 5B\",\n \"postal_code\": \"94102\",\n \"state\": \"CA\"\n },\n \"email\": \"jane@example.com\",\n \"type\": \"individual\"\n },\n \"dispute\": {\n \"amount\": 2990,\n \"currency\": \"USD\",\n \"date\": \"2026-04-01T00:00:00.000Z\",\n \"reason\": \"fraud\",\n \"raised_by\": \"cardholder\"\n },\n \"merchant\": {\n \"name\": \"FoodHub\",\n \"category_code\": \"5812\",\n \"issuer_id\": \"8201132789\"\n },\n \"transaction\": {\n \"amount\": 2990,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"billing_cycle_day\": 15,\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"type\": \"credit\"\n },\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\",\n \"network_details\": {\n \"amex\": {\n \"transaction_id\": \"<string>\",\n \"electronic_commerce_indicator\": \"05\"\n },\n \"mastercard\": {\n \"switch_serial_number\": \"<string>\"\n }\n },\n \"system\": \"dual_message\"\n },\n \"case_id\": \"case_abc123\",\n \"custom_fields\": {},\n \"issuer_evidence\": {\n \"amount_correction\": {\n \"amount\": 2,\n \"currency\": \"<string>\"\n },\n \"cancellation\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"id\": \"<string>\",\n \"policy_provided\": true\n },\n \"card\": {\n \"cardholder_has_possession\": true,\n \"is_active\": true,\n \"lost_date\": \"2023-11-07T05:31:56Z\"\n },\n \"cardholder_explanation\": \"<string>\",\n \"delivery\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"expected_date\": \"2023-11-07T05:31:56Z\"\n },\n \"documentation\": [\n \"<string>\"\n ],\n \"fraud\": {\n \"submit_report\": true,\n \"was_reported\": true\n },\n \"issuer_explanation\": \"<string>\",\n \"merchant_contact\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"prohibited_reason\": \"<string>\",\n \"was_attempted\": true,\n \"was_successful\": true\n },\n \"prior_transaction\": {\n \"amount\": 123,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\n \"currency\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\"\n },\n \"product\": {\n \"condition\": \"<string>\",\n \"description\": \"<string>\",\n \"order_id\": \"<string>\"\n },\n \"refund\": {\n \"description\": \"<string>\",\n \"policy_provided\": true,\n \"promise_date\": \"2023-11-07T05:31:56Z\",\n \"was_promised\": true\n },\n \"return\": {\n \"date\": \"2023-11-07T05:31:56Z\",\n \"description\": \"<string>\",\n \"policy_provided\": true,\n \"shipping\": {\n \"carrier\": \"<string>\",\n \"tracking_number\": \"<string>\"\n },\n \"was_attempted\": true,\n \"was_successful\": true\n },\n \"service\": {\n \"end_date\": \"2023-11-07T05:31:56Z\"\n }\n },\n \"program_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"reason\": \"fraud\"\n}"
response = http.request(request)
puts response.read_body{
"cardholder": {
"issuer_id": "9529456289",
"name": "Jane Smith",
"billing_address": {
"city": "San Francisco",
"country": "US",
"line1": "742 Evergreen Terrace",
"line2": "Unit 5B",
"postal_code": "94102",
"state": "CA"
},
"email": "jane@example.com",
"type": "individual"
},
"case_id": "case_abc123",
"claim_id": "claim_abc123",
"created": "2026-04-01T00:00:00.000Z",
"custom_fields": {},
"dispute": {
"amount": 2990,
"currency": "USD",
"date": "2026-04-01T00:00:00.000Z",
"reason": "fraud",
"raised_by": "cardholder"
},
"issuer_evidence": {
"amount_correction": {
"amount": 2,
"currency": "<string>"
},
"cancellation": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"id": "<string>",
"policy_provided": true
},
"card": {
"cardholder_has_possession": true,
"is_active": true,
"lost_date": "2023-11-07T05:31:56Z"
},
"cardholder_explanation": "<string>",
"delivery": {
"date": "2023-11-07T05:31:56Z",
"expected_date": "2023-11-07T05:31:56Z"
},
"documentation": [
"<string>"
],
"fraud": {
"submit_report": true,
"was_reported": true
},
"issuer_explanation": "<string>",
"merchant_contact": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"prohibited_reason": "<string>",
"was_attempted": true,
"was_successful": true
},
"prior_transaction": {
"amount": 123,
"arn": "48162855246353338636162",
"card": {
"expiry_month": 12,
"expiry_year": 2028,
"issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
"last4": "4242",
"network": "mastercard",
"type": "credit"
},
"currency": "<string>",
"date": "2023-11-07T05:31:56Z",
"issuer_id": "85cfda4d06b8440db3ec15af04061c98"
},
"product": {
"condition": "<string>",
"description": "<string>",
"order_id": "<string>"
},
"refund": {
"description": "<string>",
"policy_provided": true,
"promise_date": "2023-11-07T05:31:56Z",
"was_promised": true
},
"return": {
"date": "2023-11-07T05:31:56Z",
"description": "<string>",
"policy_provided": true,
"shipping": {
"carrier": "<string>",
"tracking_number": "<string>"
},
"was_attempted": true,
"was_successful": true
},
"service": {
"end_date": "2023-11-07T05:31:56Z"
}
},
"merchant": {
"name": "FoodHub",
"category_code": "5812",
"issuer_id": "8201132789"
},
"program_id": "550e8400-e29b-41d4-a716-446655440000",
"reason": "fraud",
"resolution_due_date": "2026-07-01T00:00:00.000Z",
"status": "created",
"transaction": {
"amount": 2990,
"arn": "48162855246353338636162",
"card": {
"last4": "4242",
"network": "mastercard",
"billing_cycle_day": 15,
"expiry_month": 12,
"expiry_year": 2028,
"issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb",
"type": "credit"
},
"currency": "USD",
"date": "2026-03-15T00:00:00.000Z",
"issuer_id": "85cfda4d06b8440db3ec15af04061c98",
"network_details": {
"amex": {
"transaction_id": "<string>",
"electronic_commerce_indicator": "05"
},
"mastercard": {
"switch_serial_number": "<string>"
}
},
"system": "dual_message"
}
}{
"message": "Case has been filed with the card network and cannot be updated."
}Authorizations
Use your API key as the username. No password is required.
Path Parameters
Body
application/json
Case data for creating a new case.
Details of the cardholder.
Show child attributes
Show child attributes
Dispute details for the case.
Show child attributes
Show child attributes
Details of the merchant.
Show child attributes
Show child attributes
Details of the disputed transaction.
Show child attributes
Show child attributes
Optional unique identifier for the case. If not provided, one will be generated automatically.
Maximum string length:
126Example:
"case_abc123"
Custom key-value pairs for storing additional data with your cases. See Custom Fields documentation for more details.
Issuer evidence for the dispute.
Show child attributes
Show child attributes
Your unique identifier for the card program the case belongs to.
Maximum string length:
126Example:
"550e8400-e29b-41d4-a716-446655440000"
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 updated case.
Details of the cardholder.
Show child attributes
Show child attributes
Unique identifier for the case.
Example:
"case_abc123"
The claim this case belongs to. Read-only. Cases are added to claims using the claims API.
Example:
"claim_abc123"
When the case was created. ISO 8601 format.
Example:
"2026-04-01T00:00:00.000Z"
Custom key-value pairs for storing additional data with your cases. See Custom Fields documentation for more details.
Dispute details for the case.
Show child attributes
Show child attributes
Issuer evidence for the dispute.
Show child attributes
Show child attributes
Details of the merchant.
Show child attributes
Show child attributes
Your unique identifier for the card program the case belongs to.
Maximum string length:
126Example:
"550e8400-e29b-41d4-a716-446655440000"
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"
The deadline by which the case must be resolved. Read-only. ISO 8601 format.
Example:
"2026-07-01T00:00:00.000Z"
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"
Details of the disputed transaction.
Show child attributes
Show child attributes
⌘I