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"
}
}
}
}
'import requests
url = "https://api.decisionly.com/v2/issuer/cases"
payload = {
"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" } }
}
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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'}}
}
})
};
fetch('https://api.decisionly.com/v2/issuer/cases', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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'
]
]
]
]),
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"
payload := strings.NewReader("{\n \"cardholder\": {\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\": \"susie@example.com\",\n \"issuer_id\": \"9529456289\",\n \"name\": \"Susie Chargeback\",\n \"type\": \"individual\"\n },\n \"custom_fields\": {\n \"card_program\": \"CardHub\",\n \"wallet_type\": \"mobile\"\n },\n \"dispute\": {\n \"amount\": 299,\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T13:12:18.198-08:00\",\n \"raised_by\": \"cardholder\",\n \"reason\": \"product_not_received\"\n },\n \"issuer_evidence\": {\n \"cardholder_explanation\": \"I never received this order\"\n },\n \"merchant\": {\n \"category_code\": \"5734\",\n \"issuer_id\": \"8201132789\",\n \"name\": \"FoodHub\"\n },\n \"transaction\": {\n \"amount\": 299,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"expiry_month\": 6,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T13:12:18.198-08:00\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\",\n \"network_details\": {\n \"mastercard\": {\n \"switch_serial_number\": \"242025095\"\n }\n }\n }\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.decisionly.com/v2/issuer/cases")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"cardholder\": {\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\": \"susie@example.com\",\n \"issuer_id\": \"9529456289\",\n \"name\": \"Susie Chargeback\",\n \"type\": \"individual\"\n },\n \"custom_fields\": {\n \"card_program\": \"CardHub\",\n \"wallet_type\": \"mobile\"\n },\n \"dispute\": {\n \"amount\": 299,\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T13:12:18.198-08:00\",\n \"raised_by\": \"cardholder\",\n \"reason\": \"product_not_received\"\n },\n \"issuer_evidence\": {\n \"cardholder_explanation\": \"I never received this order\"\n },\n \"merchant\": {\n \"category_code\": \"5734\",\n \"issuer_id\": \"8201132789\",\n \"name\": \"FoodHub\"\n },\n \"transaction\": {\n \"amount\": 299,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"expiry_month\": 6,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T13:12:18.198-08:00\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\",\n \"network_details\": {\n \"mastercard\": {\n \"switch_serial_number\": \"242025095\"\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.decisionly.com/v2/issuer/cases")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cardholder\": {\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\": \"susie@example.com\",\n \"issuer_id\": \"9529456289\",\n \"name\": \"Susie Chargeback\",\n \"type\": \"individual\"\n },\n \"custom_fields\": {\n \"card_program\": \"CardHub\",\n \"wallet_type\": \"mobile\"\n },\n \"dispute\": {\n \"amount\": 299,\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T13:12:18.198-08:00\",\n \"raised_by\": \"cardholder\",\n \"reason\": \"product_not_received\"\n },\n \"issuer_evidence\": {\n \"cardholder_explanation\": \"I never received this order\"\n },\n \"merchant\": {\n \"category_code\": \"5734\",\n \"issuer_id\": \"8201132789\",\n \"name\": \"FoodHub\"\n },\n \"transaction\": {\n \"amount\": 299,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"expiry_month\": 6,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T13:12:18.198-08:00\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\",\n \"network_details\": {\n \"mastercard\": {\n \"switch_serial_number\": \"242025095\"\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"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",
"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"
}
}v2 Cases
Create a case
Creates a new case.
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"
}
}
}
}
'import requests
url = "https://api.decisionly.com/v2/issuer/cases"
payload = {
"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" } }
}
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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'}}
}
})
};
fetch('https://api.decisionly.com/v2/issuer/cases', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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'
]
]
]
]),
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"
payload := strings.NewReader("{\n \"cardholder\": {\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\": \"susie@example.com\",\n \"issuer_id\": \"9529456289\",\n \"name\": \"Susie Chargeback\",\n \"type\": \"individual\"\n },\n \"custom_fields\": {\n \"card_program\": \"CardHub\",\n \"wallet_type\": \"mobile\"\n },\n \"dispute\": {\n \"amount\": 299,\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T13:12:18.198-08:00\",\n \"raised_by\": \"cardholder\",\n \"reason\": \"product_not_received\"\n },\n \"issuer_evidence\": {\n \"cardholder_explanation\": \"I never received this order\"\n },\n \"merchant\": {\n \"category_code\": \"5734\",\n \"issuer_id\": \"8201132789\",\n \"name\": \"FoodHub\"\n },\n \"transaction\": {\n \"amount\": 299,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"expiry_month\": 6,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T13:12:18.198-08:00\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\",\n \"network_details\": {\n \"mastercard\": {\n \"switch_serial_number\": \"242025095\"\n }\n }\n }\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.decisionly.com/v2/issuer/cases")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"cardholder\": {\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\": \"susie@example.com\",\n \"issuer_id\": \"9529456289\",\n \"name\": \"Susie Chargeback\",\n \"type\": \"individual\"\n },\n \"custom_fields\": {\n \"card_program\": \"CardHub\",\n \"wallet_type\": \"mobile\"\n },\n \"dispute\": {\n \"amount\": 299,\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T13:12:18.198-08:00\",\n \"raised_by\": \"cardholder\",\n \"reason\": \"product_not_received\"\n },\n \"issuer_evidence\": {\n \"cardholder_explanation\": \"I never received this order\"\n },\n \"merchant\": {\n \"category_code\": \"5734\",\n \"issuer_id\": \"8201132789\",\n \"name\": \"FoodHub\"\n },\n \"transaction\": {\n \"amount\": 299,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"expiry_month\": 6,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T13:12:18.198-08:00\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\",\n \"network_details\": {\n \"mastercard\": {\n \"switch_serial_number\": \"242025095\"\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.decisionly.com/v2/issuer/cases")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cardholder\": {\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\": \"susie@example.com\",\n \"issuer_id\": \"9529456289\",\n \"name\": \"Susie Chargeback\",\n \"type\": \"individual\"\n },\n \"custom_fields\": {\n \"card_program\": \"CardHub\",\n \"wallet_type\": \"mobile\"\n },\n \"dispute\": {\n \"amount\": 299,\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T13:12:18.198-08:00\",\n \"raised_by\": \"cardholder\",\n \"reason\": \"product_not_received\"\n },\n \"issuer_evidence\": {\n \"cardholder_explanation\": \"I never received this order\"\n },\n \"merchant\": {\n \"category_code\": \"5734\",\n \"issuer_id\": \"8201132789\",\n \"name\": \"FoodHub\"\n },\n \"transaction\": {\n \"amount\": 299,\n \"arn\": \"48162855246353338636162\",\n \"card\": {\n \"expiry_month\": 6,\n \"expiry_year\": 2028,\n \"issuer_id\": \"b5te350d5135ab64a8t3c1097tadetd9ettb\",\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T13:12:18.198-08:00\",\n \"issuer_id\": \"85cfda4d06b8440db3ec15af04061c98\",\n \"network_details\": {\n \"mastercard\": {\n \"switch_serial_number\": \"242025095\"\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"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",
"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
Use your API key as the username. No password is required.
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 newly created 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