Create Dispute

post

https://api.chargeflow.io/public/2025-04-01/platform/disputes

Creates a dispute in Chargeflow that can either be viewed through the Chargeflow platform or managed by Chargeflow.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

source_id

string

required

length ≤ 128

The unique dispute identifier appears on the source (processor) from which the dispute originated.

account_id

string

required

^[0-9a-fA-F]{24}$

The unique Chargeflow account identifier to which the dispute belongs. (Platforms only)

created_at

date-time

required

The time at which the dispute was created at the processor in ISO 8601 format.

reason

string

enum

required

The reason the cardholder has disputed the transaction.

Allowed:

due_by

date-time

required

The deadline to submit evidence to challenge the dispute in ISO 8601 format.

amount

number

required

≥ 0

Disputed amount. Equal to or less than the disputed transaction amount.

currency

string

required

length between 3 and 3

^[A-Z]{3}$

Three-letter ISO 4217 currency code in uppercase.

status

string

enum

required

The current status of the dispute.

Allowed:

stage

string

enum

Defaults to Chargeback

The stage of the dispute. Default is chargeback.

Allowed:

transaction

object

Creates a new Chargeflow transaction.

subscription

object

Creates a new Chargeflow subscription.

order

object

Creates a new Chargeflow order.

Responses

400

Bad Request:
- User is not a platform
- EAAS is not enabled for this platform
- a descriptive validation message when dispute processing rejects the request

404

Not Found - a resource referenced in the request was not found

502

Bad Gateway - an upstream service failed to process the request

503

Service Unavailable - the request was throttled, retry later

200Dispute created successfully

401Unauthorized

403Forbidden

500Internal Server Error