Disputes

Upload Evidence

Authorization

apiKey

x-api-key<token>

Your Chargeflow API key, sent on every request. Generate one in the Chargeflow App, or see API keys.

In: header

Path Parameters

disputeId*string

The unique Chargeflow object identifier of the dispute.

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

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

file*file

Formatbinary

evidenceUploadCategory*string

The category of the evidence upload

Value in

"tracking_information"
"customer_communication"
"invoice"

`application/json`

curl -X POST "https://example.com/public/2025-04-01/disputes/66e6ea9ecd94925a9f8060d9/evidence" \  -F file="string" \  -F evidenceUploadCategory="invoice"

{  "requestId": "string",  "evidenceId": "string"}

Get Dispute by ID

Authorization

apiKey

x-api-key<token>

Your Chargeflow API key, sent on every request. Generate one in the Chargeflow App, or see API keys.

In: header

Path Parameters

disputeId*string

The unique Chargeflow object identifier of the dispute.

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

Available Expansions

Use the expand parameter to include additional resource details in the response.

Available options:

Parameter	Description
`transaction`	Full payment transaction details including amount, currency, payment method and more
`order`	Complete order details including products, shipping, and fulfillment and more
`subscription`	Complete subscription details including plan, frequency, cancellation reason and more
`customer_communication`	Complete customer communication details including messages, sender, and more

`application/json`

curl -X GET "https://example.com/public/2025-04-01/disputes/66e6ea9ecd94925a9f8060d9"

{  "id": "66e6ea9ecd94925a9f8060d9",  "source": "stripe",  "source_id": "du_123456789",  "account_id": "66e6ea9ecd94925a9f8060d9",  "ext_account_id": "acc_123456",  "created_at": "2024-02-10T12:00:00Z",  "reason": "fraud",  "due_by": "2024-02-20T12:00:00Z",  "amount": 100,  "currency": "USD",  "status": "needs_response",  "stage": "Chargeback",  "closed_at": "2025-01-27T10:00:00Z",  "transaction": "66e6ea9ecd94925a9f8060d9",  "subscription": "66e6ea9ecd94925a9f8060d9",  "order": "ord_1234567890"}

Enrich Dispute

Authorization

apiKey

x-api-key<token>

Your Chargeflow API key, sent on every request. Generate one in the Chargeflow App, or see API keys.

In: header

Path Parameters

disputeId*string

The unique Chargeflow object identifier of the dispute.

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

transaction?

A transaction represents a money exchange between a buyer and a merchant in return for a physical product, digital product, service, booking, or other goods and offerings.

order?

An order is a record of a customer's purchase request, detailing the items bought, payment information, fulfillment status, and more.

`application/json`

curl -X PATCH "https://example.com/public/2025-04-01/disputes/66e6ea9ecd94925a9f8060d9" \  -H "Content-Type: application/json" \  -d '{    "transaction": {      "source_id": "tx_1234567890",      "created_at": "2024-02-10T12:00:00Z",      "type": "paid",      "amount": 100,      "currency": "USD",      "payment_method": {        "type": "card",        "name": "John Doe",        "last4": "1234",        "expiry_month": 1,        "expiry_year": 2025,        "brand": "visa"      }    }  }'

{  "id": "66e6ea9ecd94925a9f8060d9",  "source": "stripe",  "source_id": "du_123456789",  "account_id": "66e6ea9ecd94925a9f8060d9",  "ext_account_id": "acc_123456",  "created_at": "2024-02-10T12:00:00Z",  "reason": "fraud",  "due_by": "2024-02-20T12:00:00Z",  "amount": 100,  "currency": "USD",  "status": "needs_response",  "stage": "Chargeback",  "closed_at": "2025-01-27T10:00:00Z",  "transaction": "66e6ea9ecd94925a9f8060d9",  "subscription": "66e6ea9ecd94925a9f8060d9",  "order": "ord_1234567890"}

Create Subscription

Authorization

apiKey

x-api-key<token>

Your Chargeflow API key, sent on every request. Generate one in the Chargeflow App, or see API keys.

In: header

Path Parameters

disputeId*string

The unique Chargeflow object identifier of the dispute.

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Creates a new Chargeflow subscription.

source_id*string

The unique subscription identifier appears on the source from which the subscription originated.

Lengthlength <= 128

account_id?string

The unique Chargeflow account identifier to which the subscription belongs. This field is required for platform users.

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

created_at*string

The time at which the subscription was created at the source in ISO 8601 format.

Formatdate-time

start_date*string

The time at which the subscription was started at the source in ISO 8601 format.

Formatdate-time

frequency*string

The frequency at which a subscription is billed.

Value in

"day"
"week"
"month"
"year"

frequency_count*integer

The number of intervals per billing cycle. For example, if frequency = month and frequency_count = 1, the subscription renews every month. If frequency_count = 3, the subscription renews every three months.

Range1 <= value

collection_method?string

The billing method for the subscription.

Default"automatically"

Value in

"automatically"
"automatically_with_reminder"
"send_invoice"

updated_at?|

The time at which the subscription was updated at the source in ISO 8601 format.

Formatdate-time

end_date?|

The time at which the subscription was ended at the source in ISO 8601 format.

Formatdate-time

cancellation_date?|

The time at which the subscription was requested to be canceled at the source in ISO 8601 format. Returns null if a cancellation is never requested.

Formatdate-time

cancellation_reason?|

The submitted reason for why the subscription has canceled.

Value in

"too_expensive"
"low_quality"
"unused"
"too_complex"
"missing_features"

trial_start?|

The time at which the trial of the subscription began at the source in ISO 8601 format. Returns null if no trial is offered or if the trial was not utilized.

Formatdate-time

trial_end?|

The time at which the trial of the subscription ended at the source in ISO 8601 format. Returns null if no trial is offered or if the trial was not utilized.

Formatdate-time

renews_at?|

The time at which the subscription cycle renews at the source in ISO 8601 format. Returns null if the subscription has been canceled.

Formatdate-time

plan_name?|

The name of the plan associated with the subscription, representing the specific offering or service tier the subscriber is enrolled in.

pricing_model?string

The pricing model associated with the subscription.

Default"fixed_price"

Value in

"fixed_price"
"usage_base"

status?string

The current status of the subscription.

Default"active"

Value in

"active"
"inactive"
"canceled"

Response Body

`application/json`

curl -X POST "https://example.com/public/2025-04-01/disputes/66e6ea9ecd94925a9f8060d9/subscription" \  -H "Content-Type: application/json" \  -d '{    "source_id": "source_sub_1234567890",    "created_at": "2024-02-10T12:00:00Z",    "start_date": "2024-02-10T12:00:00Z",    "frequency": "month",    "frequency_count": 1  }'

{  "id": "66e6ea9ecd94925a9f8060d9",  "source_id": "source_sub_1234567890",  "account_id": "66e6ea9ecd94925a9f8060d9",  "ext_account_id": "acc_123456",  "created_at": "2024-02-10T12:00:00Z",  "updated_at": "2024-02-15T12:00:00Z",  "start_date": "2024-02-10T12:00:00Z",  "end_date": "2024-08-10T12:00:00Z",  "cancellation_date": "2024-07-10T12:00:00Z",  "frequency": "month",  "frequency_count": 1,  "cancellation_reason": "too_expensive",  "collection_method": "automatically",  "trial_start": "2024-02-10T12:00:00Z",  "trial_end": "2024-03-10T12:00:00Z",  "renews_at": "2024-03-10T12:00:00Z",  "plan_name": "Pro Plan",  "pricing_model": "fixed_price",  "status": "active"}

Get Disputes

Authorization

apiKey

x-api-key<token>

Your Chargeflow API key, sent on every request. Generate one in the Chargeflow App, or see API keys.

In: header

Query Parameters

offset?integer

The page number of the current response

Range0 <= value

Default0

limit?integer

The number of disputes per page

Range1 <= value <= 100

Default25

Response Body

`application/json`

curl -X GET "https://example.com/public/2025-04-01/disputes?offset=0&limit=10"

{  "disputes": [],  "pagination": {    "totalCount": 0,    "offset": 0,    "limit": 25,    "totalPages": 0  }}

Disputes

200application/json

400application/json

403application/json

404application/json

500application/json

Available Expansions

200application/json

400application/json

401application/json

403application/json

404application/json

500application/json

200application/json

400application/json

401application/json

403application/json

404application/json

500application/json

200application/json

400application/json

401application/json

403application/json

500application/json

200application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`