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",
"issuer_id": "9529456289",
"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": "2026-03-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": "2026-03-16T00:00:00.000Z",
"system": "dual_message"
}
}
],
"claim_id": "claim_abc123",
"dispute": {
"date": "2026-03-15T00:00:00.000Z",
"raised_by": "cardholder",
"reason": "fraud"
},
"issuer_evidence": {
"cardholder_explanation": "I did not authorize these transactions",
"documentation": [
"file_abc123",
"file_def456"
]
}
}
'import requests
url = "https://api.decisionly.com/v2/issuer/new_claim"
payload = {
"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",
"issuer_id": "9529456289",
"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": "2026-03-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": "2026-03-16T00:00:00.000Z",
"system": "dual_message"
}
}
],
"claim_id": "claim_abc123",
"dispute": {
"date": "2026-03-15T00:00:00.000Z",
"raised_by": "cardholder",
"reason": "fraud"
},
"issuer_evidence": {
"cardholder_explanation": "I did not authorize these transactions",
"documentation": ["file_abc123", "file_def456"]
}
}
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({
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',
issuer_id: '9529456289',
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: '2026-03-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: '2026-03-16T00:00:00.000Z',
system: 'dual_message'
}
}
],
claim_id: 'claim_abc123',
dispute: {date: '2026-03-15T00:00:00.000Z', raised_by: 'cardholder', reason: 'fraud'},
issuer_evidence: {
cardholder_explanation: 'I did not authorize these transactions',
documentation: ['file_abc123', 'file_def456']
}
})
};
fetch('https://api.decisionly.com/v2/issuer/new_claim', 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/new_claim",
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([
'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',
'issuer_id' => '9529456289',
'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' => '2026-03-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' => '2026-03-16T00:00:00.000Z',
'system' => 'dual_message'
]
]
],
'claim_id' => 'claim_abc123',
'dispute' => [
'date' => '2026-03-15T00:00:00.000Z',
'raised_by' => 'cardholder',
'reason' => 'fraud'
],
'issuer_evidence' => [
'cardholder_explanation' => 'I did not authorize these transactions',
'documentation' => [
'file_abc123',
'file_def456'
]
]
]),
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/new_claim"
payload := strings.NewReader("{\n \"card\": {\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\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\": \"jane@example.com\",\n \"issuer_id\": \"9529456289\",\n \"name\": \"Jane Smith\",\n \"type\": \"individual\"\n },\n \"cases\": [\n {\n \"case_id\": \"case_abc123\",\n \"dispute\": {\n \"amount\": 5000,\n \"currency\": \"USD\"\n },\n \"merchant\": {\n \"category_code\": \"5812\",\n \"name\": \"Example Merchant 1\"\n },\n \"transaction\": {\n \"amount\": 5000,\n \"arn\": \"12345678901234567890123\",\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"system\": \"dual_message\"\n }\n },\n {\n \"case_id\": \"case_def456\",\n \"dispute\": {\n \"amount\": 3000,\n \"currency\": \"USD\"\n },\n \"merchant\": {\n \"category_code\": \"5812\",\n \"name\": \"Example Merchant 2\"\n },\n \"transaction\": {\n \"amount\": 3000,\n \"arn\": \"98765432109876543210987\",\n \"currency\": \"USD\",\n \"date\": \"2026-03-16T00:00:00.000Z\",\n \"system\": \"dual_message\"\n }\n }\n ],\n \"claim_id\": \"claim_abc123\",\n \"dispute\": {\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"raised_by\": \"cardholder\",\n \"reason\": \"fraud\"\n },\n \"issuer_evidence\": {\n \"cardholder_explanation\": \"I did not authorize these transactions\",\n \"documentation\": [\n \"file_abc123\",\n \"file_def456\"\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/new_claim")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"card\": {\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\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\": \"jane@example.com\",\n \"issuer_id\": \"9529456289\",\n \"name\": \"Jane Smith\",\n \"type\": \"individual\"\n },\n \"cases\": [\n {\n \"case_id\": \"case_abc123\",\n \"dispute\": {\n \"amount\": 5000,\n \"currency\": \"USD\"\n },\n \"merchant\": {\n \"category_code\": \"5812\",\n \"name\": \"Example Merchant 1\"\n },\n \"transaction\": {\n \"amount\": 5000,\n \"arn\": \"12345678901234567890123\",\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"system\": \"dual_message\"\n }\n },\n {\n \"case_id\": \"case_def456\",\n \"dispute\": {\n \"amount\": 3000,\n \"currency\": \"USD\"\n },\n \"merchant\": {\n \"category_code\": \"5812\",\n \"name\": \"Example Merchant 2\"\n },\n \"transaction\": {\n \"amount\": 3000,\n \"arn\": \"98765432109876543210987\",\n \"currency\": \"USD\",\n \"date\": \"2026-03-16T00:00:00.000Z\",\n \"system\": \"dual_message\"\n }\n }\n ],\n \"claim_id\": \"claim_abc123\",\n \"dispute\": {\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"raised_by\": \"cardholder\",\n \"reason\": \"fraud\"\n },\n \"issuer_evidence\": {\n \"cardholder_explanation\": \"I did not authorize these transactions\",\n \"documentation\": [\n \"file_abc123\",\n \"file_def456\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.decisionly.com/v2/issuer/new_claim")
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 \"card\": {\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\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\": \"jane@example.com\",\n \"issuer_id\": \"9529456289\",\n \"name\": \"Jane Smith\",\n \"type\": \"individual\"\n },\n \"cases\": [\n {\n \"case_id\": \"case_abc123\",\n \"dispute\": {\n \"amount\": 5000,\n \"currency\": \"USD\"\n },\n \"merchant\": {\n \"category_code\": \"5812\",\n \"name\": \"Example Merchant 1\"\n },\n \"transaction\": {\n \"amount\": 5000,\n \"arn\": \"12345678901234567890123\",\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"system\": \"dual_message\"\n }\n },\n {\n \"case_id\": \"case_def456\",\n \"dispute\": {\n \"amount\": 3000,\n \"currency\": \"USD\"\n },\n \"merchant\": {\n \"category_code\": \"5812\",\n \"name\": \"Example Merchant 2\"\n },\n \"transaction\": {\n \"amount\": 3000,\n \"arn\": \"98765432109876543210987\",\n \"currency\": \"USD\",\n \"date\": \"2026-03-16T00:00:00.000Z\",\n \"system\": \"dual_message\"\n }\n }\n ],\n \"claim_id\": \"claim_abc123\",\n \"dispute\": {\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"raised_by\": \"cardholder\",\n \"reason\": \"fraud\"\n },\n \"issuer_evidence\": {\n \"cardholder_explanation\": \"I did not authorize these transactions\",\n \"documentation\": [\n \"file_abc123\",\n \"file_def456\"\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"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",
"issuer_id": "9529456289",
"name": "Jane Smith",
"type": "individual"
},
"case_id": "case_abc123",
"claim_id": "claim_abc123",
"created": "2026-04-01T00:00:00.000Z",
"dispute": {
"amount": 5000,
"currency": "USD",
"date": "2026-03-15T00:00:00.000Z",
"raised_by": "cardholder",
"reason": "fraud"
},
"issuer_evidence": {
"cardholder_explanation": "I did not authorize these transactions",
"documentation": [
"file_abc123",
"file_def456"
]
},
"merchant": {
"category_code": "5812",
"name": "Example Merchant 1"
},
"status": "created",
"transaction": {
"amount": 5000,
"arn": "12345678901234567890123",
"card": {
"expiry_month": 12,
"expiry_year": 2028,
"last4": "4242",
"network": "mastercard",
"type": "credit"
},
"currency": "USD",
"date": "2026-03-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",
"issuer_id": "9529456289",
"name": "Jane Smith",
"type": "individual"
},
"case_id": "case_def456",
"claim_id": "claim_abc123",
"created": "2026-04-01T00:00:00.000Z",
"dispute": {
"amount": 3000,
"currency": "USD",
"date": "2026-03-15T00:00:00.000Z",
"raised_by": "cardholder",
"reason": "fraud"
},
"issuer_evidence": {
"cardholder_explanation": "I did not authorize these transactions",
"documentation": [
"file_abc123",
"file_def456"
]
},
"merchant": {
"category_code": "5812",
"name": "Example Merchant 2"
},
"status": "created",
"transaction": {
"amount": 3000,
"arn": "98765432109876543210987",
"card": {
"expiry_month": 12,
"expiry_year": 2028,
"last4": "4242",
"network": "mastercard",
"type": "credit"
},
"currency": "USD",
"date": "2026-03-16T00:00:00.000Z",
"system": "dual_message"
}
}
],
"claim_id": "claim_abc123",
"created": "2026-04-01T00:00:00.000Z",
"status": "open",
"updated": "2026-04-01T00:00:00.000Z"
}Claims
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 --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",
"issuer_id": "9529456289",
"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": "2026-03-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": "2026-03-16T00:00:00.000Z",
"system": "dual_message"
}
}
],
"claim_id": "claim_abc123",
"dispute": {
"date": "2026-03-15T00:00:00.000Z",
"raised_by": "cardholder",
"reason": "fraud"
},
"issuer_evidence": {
"cardholder_explanation": "I did not authorize these transactions",
"documentation": [
"file_abc123",
"file_def456"
]
}
}
'import requests
url = "https://api.decisionly.com/v2/issuer/new_claim"
payload = {
"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",
"issuer_id": "9529456289",
"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": "2026-03-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": "2026-03-16T00:00:00.000Z",
"system": "dual_message"
}
}
],
"claim_id": "claim_abc123",
"dispute": {
"date": "2026-03-15T00:00:00.000Z",
"raised_by": "cardholder",
"reason": "fraud"
},
"issuer_evidence": {
"cardholder_explanation": "I did not authorize these transactions",
"documentation": ["file_abc123", "file_def456"]
}
}
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({
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',
issuer_id: '9529456289',
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: '2026-03-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: '2026-03-16T00:00:00.000Z',
system: 'dual_message'
}
}
],
claim_id: 'claim_abc123',
dispute: {date: '2026-03-15T00:00:00.000Z', raised_by: 'cardholder', reason: 'fraud'},
issuer_evidence: {
cardholder_explanation: 'I did not authorize these transactions',
documentation: ['file_abc123', 'file_def456']
}
})
};
fetch('https://api.decisionly.com/v2/issuer/new_claim', 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/new_claim",
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([
'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',
'issuer_id' => '9529456289',
'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' => '2026-03-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' => '2026-03-16T00:00:00.000Z',
'system' => 'dual_message'
]
]
],
'claim_id' => 'claim_abc123',
'dispute' => [
'date' => '2026-03-15T00:00:00.000Z',
'raised_by' => 'cardholder',
'reason' => 'fraud'
],
'issuer_evidence' => [
'cardholder_explanation' => 'I did not authorize these transactions',
'documentation' => [
'file_abc123',
'file_def456'
]
]
]),
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/new_claim"
payload := strings.NewReader("{\n \"card\": {\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\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\": \"jane@example.com\",\n \"issuer_id\": \"9529456289\",\n \"name\": \"Jane Smith\",\n \"type\": \"individual\"\n },\n \"cases\": [\n {\n \"case_id\": \"case_abc123\",\n \"dispute\": {\n \"amount\": 5000,\n \"currency\": \"USD\"\n },\n \"merchant\": {\n \"category_code\": \"5812\",\n \"name\": \"Example Merchant 1\"\n },\n \"transaction\": {\n \"amount\": 5000,\n \"arn\": \"12345678901234567890123\",\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"system\": \"dual_message\"\n }\n },\n {\n \"case_id\": \"case_def456\",\n \"dispute\": {\n \"amount\": 3000,\n \"currency\": \"USD\"\n },\n \"merchant\": {\n \"category_code\": \"5812\",\n \"name\": \"Example Merchant 2\"\n },\n \"transaction\": {\n \"amount\": 3000,\n \"arn\": \"98765432109876543210987\",\n \"currency\": \"USD\",\n \"date\": \"2026-03-16T00:00:00.000Z\",\n \"system\": \"dual_message\"\n }\n }\n ],\n \"claim_id\": \"claim_abc123\",\n \"dispute\": {\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"raised_by\": \"cardholder\",\n \"reason\": \"fraud\"\n },\n \"issuer_evidence\": {\n \"cardholder_explanation\": \"I did not authorize these transactions\",\n \"documentation\": [\n \"file_abc123\",\n \"file_def456\"\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/new_claim")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"card\": {\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\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\": \"jane@example.com\",\n \"issuer_id\": \"9529456289\",\n \"name\": \"Jane Smith\",\n \"type\": \"individual\"\n },\n \"cases\": [\n {\n \"case_id\": \"case_abc123\",\n \"dispute\": {\n \"amount\": 5000,\n \"currency\": \"USD\"\n },\n \"merchant\": {\n \"category_code\": \"5812\",\n \"name\": \"Example Merchant 1\"\n },\n \"transaction\": {\n \"amount\": 5000,\n \"arn\": \"12345678901234567890123\",\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"system\": \"dual_message\"\n }\n },\n {\n \"case_id\": \"case_def456\",\n \"dispute\": {\n \"amount\": 3000,\n \"currency\": \"USD\"\n },\n \"merchant\": {\n \"category_code\": \"5812\",\n \"name\": \"Example Merchant 2\"\n },\n \"transaction\": {\n \"amount\": 3000,\n \"arn\": \"98765432109876543210987\",\n \"currency\": \"USD\",\n \"date\": \"2026-03-16T00:00:00.000Z\",\n \"system\": \"dual_message\"\n }\n }\n ],\n \"claim_id\": \"claim_abc123\",\n \"dispute\": {\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"raised_by\": \"cardholder\",\n \"reason\": \"fraud\"\n },\n \"issuer_evidence\": {\n \"cardholder_explanation\": \"I did not authorize these transactions\",\n \"documentation\": [\n \"file_abc123\",\n \"file_def456\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.decisionly.com/v2/issuer/new_claim")
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 \"card\": {\n \"expiry_month\": 12,\n \"expiry_year\": 2028,\n \"last4\": \"4242\",\n \"network\": \"mastercard\",\n \"type\": \"credit\"\n },\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\": \"jane@example.com\",\n \"issuer_id\": \"9529456289\",\n \"name\": \"Jane Smith\",\n \"type\": \"individual\"\n },\n \"cases\": [\n {\n \"case_id\": \"case_abc123\",\n \"dispute\": {\n \"amount\": 5000,\n \"currency\": \"USD\"\n },\n \"merchant\": {\n \"category_code\": \"5812\",\n \"name\": \"Example Merchant 1\"\n },\n \"transaction\": {\n \"amount\": 5000,\n \"arn\": \"12345678901234567890123\",\n \"currency\": \"USD\",\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"system\": \"dual_message\"\n }\n },\n {\n \"case_id\": \"case_def456\",\n \"dispute\": {\n \"amount\": 3000,\n \"currency\": \"USD\"\n },\n \"merchant\": {\n \"category_code\": \"5812\",\n \"name\": \"Example Merchant 2\"\n },\n \"transaction\": {\n \"amount\": 3000,\n \"arn\": \"98765432109876543210987\",\n \"currency\": \"USD\",\n \"date\": \"2026-03-16T00:00:00.000Z\",\n \"system\": \"dual_message\"\n }\n }\n ],\n \"claim_id\": \"claim_abc123\",\n \"dispute\": {\n \"date\": \"2026-03-15T00:00:00.000Z\",\n \"raised_by\": \"cardholder\",\n \"reason\": \"fraud\"\n },\n \"issuer_evidence\": {\n \"cardholder_explanation\": \"I did not authorize these transactions\",\n \"documentation\": [\n \"file_abc123\",\n \"file_def456\"\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"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",
"issuer_id": "9529456289",
"name": "Jane Smith",
"type": "individual"
},
"case_id": "case_abc123",
"claim_id": "claim_abc123",
"created": "2026-04-01T00:00:00.000Z",
"dispute": {
"amount": 5000,
"currency": "USD",
"date": "2026-03-15T00:00:00.000Z",
"raised_by": "cardholder",
"reason": "fraud"
},
"issuer_evidence": {
"cardholder_explanation": "I did not authorize these transactions",
"documentation": [
"file_abc123",
"file_def456"
]
},
"merchant": {
"category_code": "5812",
"name": "Example Merchant 1"
},
"status": "created",
"transaction": {
"amount": 5000,
"arn": "12345678901234567890123",
"card": {
"expiry_month": 12,
"expiry_year": 2028,
"last4": "4242",
"network": "mastercard",
"type": "credit"
},
"currency": "USD",
"date": "2026-03-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",
"issuer_id": "9529456289",
"name": "Jane Smith",
"type": "individual"
},
"case_id": "case_def456",
"claim_id": "claim_abc123",
"created": "2026-04-01T00:00:00.000Z",
"dispute": {
"amount": 3000,
"currency": "USD",
"date": "2026-03-15T00:00:00.000Z",
"raised_by": "cardholder",
"reason": "fraud"
},
"issuer_evidence": {
"cardholder_explanation": "I did not authorize these transactions",
"documentation": [
"file_abc123",
"file_def456"
]
},
"merchant": {
"category_code": "5812",
"name": "Example Merchant 2"
},
"status": "created",
"transaction": {
"amount": 3000,
"arn": "98765432109876543210987",
"card": {
"expiry_month": 12,
"expiry_year": 2028,
"last4": "4242",
"network": "mastercard",
"type": "credit"
},
"currency": "USD",
"date": "2026-03-16T00:00:00.000Z",
"system": "dual_message"
}
}
],
"claim_id": "claim_abc123",
"created": "2026-04-01T00:00:00.000Z",
"status": "open",
"updated": "2026-04-01T00:00:00.000Z"
}Authorizations
Use your API key as the username. No password is required.
Body
application/json
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 elementsShow child attributes
Show child attributes
Shared dispute information. The reason, date, and raised_by fields are shared across all cases; amount and currency are specified per case.
Show child attributes
Show child attributes
Card information (shared across all cases).
Show child attributes
Show child attributes
Details of the cardholder.
Show child attributes
Show child attributes
Optional unique identifier for the claim. If not provided, one will be generated automatically.
Maximum string length:
126Example:
"claim_abc123"
Custom fields (shared across all cases).
Issuer evidence for the dispute.
Show child attributes
Show child attributes
Response
Returns the newly created claim with all created cases.
All cases associated with this claim.
Show child attributes
Show child attributes
Unique identifier for the claim.
Example:
"claim_abc123"
When the claim was created. ISO 8601 format.
Example:
"2026-04-01T00:00:00.000Z"
The status of the claim.
Available options:
open, filed, closed Example:
"open"
⌘I