curl --request POST \
--url https://api.decisionly.com/v2/issuer/cases \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"reason": "product_not_received",
"cardholder": {
"name": "Susie Chargeback",
"email": "susie@example.com",
"issuer_id": "9529456289",
"type": "individual"
},
"merchant": {
"name": "FoodHub",
"category_code": "5734",
"issuer_id": "8201132789"
},
"transaction": {
"arn": "48162855246353338636162",
"switch_serial_number": "242025095",
"issuer_id": "85cfda4d06b8440db3ec15af04061c98",
"date": "2025-11-26T13:12:18.198-08:00",
"amount": 299,
"currency": "USD",
"system": "dual_message",
"card": {
"network": "mastercard",
"last4": "4242",
"expiry_month": 6,
"expiry_year": 2028,
"type": "credit",
"issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb"
}
},
"dispute": {
"date": "2025-11-26T13:12:18.198-08:00",
"amount": 299,
"currency": "USD",
"raised_by": "cardholder"
},
"issuer_evidence": {
"cardholder_explanation": "I never received this order"
},
"custom_fields": {
"card_program": "CardHub",
"wallet_type": "mobile"
}
}
'{
"case_id": "case_abc123",
"reason": "product_not_received",
"cardholder": {
"name": "Susie Chargeback",
"email": "susie@example.com",
"issuer_id": "9529456289",
"type": "individual"
},
"merchant": {
"name": "FoodHub",
"category_code": "5734"
},
"transaction": {
"arn": "48162855246353338636162",
"date": "2025-11-26T13:12:18.198-08:00",
"amount": 299,
"currency": "USD",
"card": {
"network": "mastercard",
"last4": "4242",
"expiry_month": 6,
"expiry_year": 2028
}
},
"dispute": {
"date": "2025-11-26T13:12:18.198-08:00",
"amount": 299,
"currency": "USD",
"raised_by": "cardholder"
},
"status": "created",
"created": "2025-02-01T00:00:00.000Z"
}Create a case
Creates a new case.
curl --request POST \
--url https://api.decisionly.com/v2/issuer/cases \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"reason": "product_not_received",
"cardholder": {
"name": "Susie Chargeback",
"email": "susie@example.com",
"issuer_id": "9529456289",
"type": "individual"
},
"merchant": {
"name": "FoodHub",
"category_code": "5734",
"issuer_id": "8201132789"
},
"transaction": {
"arn": "48162855246353338636162",
"switch_serial_number": "242025095",
"issuer_id": "85cfda4d06b8440db3ec15af04061c98",
"date": "2025-11-26T13:12:18.198-08:00",
"amount": 299,
"currency": "USD",
"system": "dual_message",
"card": {
"network": "mastercard",
"last4": "4242",
"expiry_month": 6,
"expiry_year": 2028,
"type": "credit",
"issuer_id": "b5te350d5135ab64a8t3c1097tadetd9ettb"
}
},
"dispute": {
"date": "2025-11-26T13:12:18.198-08:00",
"amount": 299,
"currency": "USD",
"raised_by": "cardholder"
},
"issuer_evidence": {
"cardholder_explanation": "I never received this order"
},
"custom_fields": {
"card_program": "CardHub",
"wallet_type": "mobile"
}
}
'{
"case_id": "case_abc123",
"reason": "product_not_received",
"cardholder": {
"name": "Susie Chargeback",
"email": "susie@example.com",
"issuer_id": "9529456289",
"type": "individual"
},
"merchant": {
"name": "FoodHub",
"category_code": "5734"
},
"transaction": {
"arn": "48162855246353338636162",
"date": "2025-11-26T13:12:18.198-08:00",
"amount": 299,
"currency": "USD",
"card": {
"network": "mastercard",
"last4": "4242",
"expiry_month": 6,
"expiry_year": 2028
}
},
"dispute": {
"date": "2025-11-26T13:12:18.198-08:00",
"amount": 299,
"currency": "USD",
"raised_by": "cardholder"
},
"status": "created",
"created": "2025-02-01T00:00:00.000Z"
}Authorizations
Use your API key as the username. No password is required.
Body
Case data for creating a new case.
The reason for the dispute.
invalid_authorization, fraud, product_not_received, product_not_as_described, product_counterfeit, subscription_canceled, credit_not_processed, duplicate_charge, incorrect_amount, cash_not_received, canceled_or_returned, other "fraud"
Details of the cardholder.
Show child attributes
Show child attributes
The name of the cardholder.
250"Jane Smith"
The email of the cardholder.
320"jane@example.com"
Your ID for the cardholder.
250"9529456289"
The type of cardholder. Defaults to individual.
individual, company "individual"
Details of the merchant.
Show child attributes
Show child attributes
The name of the merchant.
250"FoodHub"
The category code of the merchant.
4"5812"
Your ID for the merchant.
250"8201132789"
Details of the disputed transaction. Either arn or switch_serial_number is required.
Show child attributes
Show child attributes
Date of the transaction. ISO 8601 format.
"2025-01-15T00:00:00.000Z"
Settled amount of the transaction. In the smallest currency unit, such as cents.
x >= 12990
Currency of the transaction amount.
3"USD"
Details of the card used in the disputed transaction(s).
Show child attributes
Show child attributes
The card network.
visa, mastercard, amex, discover "visa"
The last four digits of the card.
"4242"
The type of card. Defaults to credit.
credit, debit "credit"
The expiration month of the card.
1 <= x <= 1212
The expiration year of the card.
2028
Your unique ID for the card (not the PAN).
250"b5te350d5135ab64a8t3c1097tadetd9ettb"
The acquirer reference number of the transaction. Either this or switch_serial_number is required.
23"48162855246353338636162"
The switch serial number for the transaction. Either this or arn is required.
9"242025095"
Your unique ID for the transaction.
250"85cfda4d06b8440db3ec15af04061c98"
The transaction system (single message or dual message).
single_message, dual_message "dual_message"
Dispute details for the case.
Show child attributes
Show child attributes
When the dispute was raised. ISO 8601 format.
"2025-02-01T00:00:00.000Z"
The disputed amount. In the smallest currency unit, such as cents.
x >= 12990
Currency of the disputed amount.
3"USD"
Was the dispute raised by the cardholder or the issuer. Defaults to cardholder.
cardholder, issuer "cardholder"
Optional unique identifier for the case. If not provided, one will be generated automatically.
126"case_abc123"
Issuer evidence for the dispute.
Show child attributes
Show child attributes
The complaint of the cardholder.
2000A description of the transaction and the dispute.
1000Details of a prior transaction. Can be a full transaction object or partial details.
Show child attributes
Show child attributes
The acquirer reference number of the transaction.
23"48162855246353338636162"
The switch serial number for the transaction.
9"242025095"
Your unique ID for the transaction.
250"85cfda4d06b8440db3ec15af04061c98"
Date of the prior transaction.
Amount of the prior transaction in smallest currency unit.
Currency code of the prior transaction.
3The transaction system (single message or dual message).
single_message, dual_message Details of the card used in the disputed transaction(s).
Show child attributes
Show child attributes
The card network.
visa, mastercard, amex, discover "visa"
The last four digits of the card.
"4242"
The type of card. Defaults to credit.
credit, debit "credit"
The expiration month of the card.
1 <= x <= 1212
The expiration year of the card.
2028
Your unique ID for the card (not the PAN).
250"b5te350d5135ab64a8t3c1097tadetd9ettb"
Details of merchant contact attempt.
Show child attributes
Show child attributes
Date of contact attempt.
Whether contact was successful.
Description of the contact attempt.
Reason if contact was prohibited.
Product return details.
Show child attributes
Show child attributes
Date of return.
Whether return was successful.
Description of the return.
Whether return policy was provided.
Product details.
Show child attributes
Show child attributes
Order or invoice ID.
Product description.
Product condition.
Type of product.
merchandise, service Cancellation details.
Show child attributes
Show child attributes
Cancellation ID.
Cancellation date.
Cancellation description.
Whether cancellation policy was provided.
Status of the card, for fraud claims.
Show child attributes
Show child attributes
Date card was lost or stolen.
Whether card is currently active.
Whether cardholder currently has the card.
Card possession status at time of transaction.
possessed, lost, stolen, never_received Array of file IDs for supporting documentation. Upload files using the file upload endpoint.
Custom key-value pairs for storing additional data with your cases. See Custom Fields documentation for more details.
Response
Returns the newly created case.
Unique identifier for the case.
"case_abc123"
The reason for the dispute.
invalid_authorization, fraud, product_not_received, product_not_as_described, product_counterfeit, subscription_canceled, credit_not_processed, duplicate_charge, incorrect_amount, cash_not_received, canceled_or_returned, other "fraud"
Details of the cardholder.
Show child attributes
Show child attributes
The name of the cardholder.
250"Jane Smith"
The email of the cardholder.
320"jane@example.com"
Your ID for the cardholder.
250"9529456289"
The type of cardholder. Defaults to individual.
individual, company "individual"
Details of the merchant.
Show child attributes
Show child attributes
The name of the merchant.
250"FoodHub"
The category code of the merchant.
4"5812"
Your ID for the merchant.
250"8201132789"
Details of the disputed transaction. Either arn or switch_serial_number is required.
Show child attributes
Show child attributes
Date of the transaction. ISO 8601 format.
"2025-01-15T00:00:00.000Z"
Settled amount of the transaction. In the smallest currency unit, such as cents.
x >= 12990
Currency of the transaction amount.
3"USD"
Details of the card used in the disputed transaction(s).
Show child attributes
Show child attributes
The card network.
visa, mastercard, amex, discover "visa"
The last four digits of the card.
"4242"
The type of card. Defaults to credit.
credit, debit "credit"
The expiration month of the card.
1 <= x <= 1212
The expiration year of the card.
2028
Your unique ID for the card (not the PAN).
250"b5te350d5135ab64a8t3c1097tadetd9ettb"
The acquirer reference number of the transaction. Either this or switch_serial_number is required.
23"48162855246353338636162"
The switch serial number for the transaction. Either this or arn is required.
9"242025095"
Your unique ID for the transaction.
250"85cfda4d06b8440db3ec15af04061c98"
The transaction system (single message or dual message).
single_message, dual_message "dual_message"
Dispute details for the case.
Show child attributes
Show child attributes
When the dispute was raised. ISO 8601 format.
"2025-02-01T00:00:00.000Z"
The disputed amount. In the smallest currency unit, such as cents.
x >= 12990
Currency of the disputed amount.
3"USD"
Was the dispute raised by the cardholder or the issuer. Defaults to cardholder.
cardholder, issuer "cardholder"
Issuer evidence for the dispute.
Show child attributes
Show child attributes
The complaint of the cardholder.
2000A description of the transaction and the dispute.
1000Details of a prior transaction. Can be a full transaction object or partial details.
Show child attributes
Show child attributes
The acquirer reference number of the transaction.
23"48162855246353338636162"
The switch serial number for the transaction.
9"242025095"
Your unique ID for the transaction.
250"85cfda4d06b8440db3ec15af04061c98"
Date of the prior transaction.
Amount of the prior transaction in smallest currency unit.
Currency code of the prior transaction.
3The transaction system (single message or dual message).
single_message, dual_message Details of the card used in the disputed transaction(s).
Show child attributes
Show child attributes
The card network.
visa, mastercard, amex, discover "visa"
The last four digits of the card.
"4242"
The type of card. Defaults to credit.
credit, debit "credit"
The expiration month of the card.
1 <= x <= 1212
The expiration year of the card.
2028
Your unique ID for the card (not the PAN).
250"b5te350d5135ab64a8t3c1097tadetd9ettb"
Details of merchant contact attempt.
Show child attributes
Show child attributes
Date of contact attempt.
Whether contact was successful.
Description of the contact attempt.
Reason if contact was prohibited.
Product return details.
Show child attributes
Show child attributes
Date of return.
Whether return was successful.
Description of the return.
Whether return policy was provided.
Product details.
Show child attributes
Show child attributes
Order or invoice ID.
Product description.
Product condition.
Type of product.
merchandise, service Cancellation details.
Show child attributes
Show child attributes
Cancellation ID.
Cancellation date.
Cancellation description.
Whether cancellation policy was provided.
Status of the card, for fraud claims.
Show child attributes
Show child attributes
Date card was lost or stolen.
Whether card is currently active.
Whether cardholder currently has the card.
Card possession status at time of transaction.
possessed, lost, stolen, never_received Array of file IDs for supporting documentation. Upload files using the file upload endpoint.
Custom key-value pairs for storing additional data with your cases. See Custom Fields documentation for more details.
The status of the case.
created, chargeback_filed, chargeback_represented, prearb_filed, prearb_rebutted, arbitration_filed, closed, won, lost "created"
The reason the case was closed.
accepted, rejected, expired, withdrawn null
When the case was created. ISO 8601 format.
"2025-02-01T00:00:00.000Z"