Skip to main content
POST
/
v0
/
disputes
Create
curl --request POST \
  --url https://api.paygentic.io/v0/disputes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "message": "<string>",
  "usageEventId": "<string>"
}'
{
  "id": "disp_m3n4o5p6q7r8s9t0",
  "object": "dispute",
  "createdAt": "2024-03-10T14:30:00Z",
  "customerId": "cust_c9d0e1f2g3h4i5j6",
  "customerMessage": "Token count appears incorrect for this request",
  "disputedAmount": "2.50",
  "merchantId": "org_k7l8m9n0o1p2q3r4",
  "merchantMessage": null,
  "resolvedAt": null,
  "status": "pending",
  "updatedAt": "2024-03-10T14:30:00Z",
  "usageEventId": "usg_u1v2w3x4y5z6a7b8"
}

Authorizations

​
Authorization
string
header
required

API key authentication

Body

application/json
​
message
string
required

Customer explanation for challenging the consumption event. Sample values: 'Token count appears incorrect for this request', 'Storage charges don't match actual usage', 'API call was made during maintenance window', 'Inference request failed but still charged'

Required string length: 10 - 1000
​
usageEventId
string
required

Usage event identifier being challenged. Sample values: 'usg_abc123xyz', 'usg_789def456'

Response

Dispute created successfully

​
id
string
required

Unique identifier for a dispute

​
object
enum<string>
default:dispute
required
Available options:
dispute
​
createdAt
string<date-time>
required
​
customerId
string
required

Customer who filed the dispute

​
customerMessage
string
required

Customer's reason for the dispute

​
disputedAmount
string<decimal>
required

Disputed charge amount in decimal dollar format. Sample values: '2.50' equals $2.50 disputed, '15.00' equals $15.00 disputed, '0.50' equals $0.50 disputed

​
merchantId
string
required

Merchant associated with the dispute

​
status
enum<string>
required

Current status of the dispute

Available options:
pending,
accepted,
declined
​
updatedAt
string<date-time>
required
​
usageEventId
string
required

The usage event being disputed

​
merchantMessage
string | null

Merchant's response to the dispute

​
resolvedAt
string<date-time> | null

When the dispute was resolved