v66

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-042174421.1 MB

Event Types

dispute_evidence.upload_failed

Occurs when an evidence upload fails for a dispute filed through the Chargebacks API (/v1/disputes).

This event is not emitted for Managed Disputes.

postWebhookdispute_evidence.upload_failed

Payload

event_type'dispute_evidence.upload_failed' required

The type of event that occurred.

createdstring date-time required

Timestamp of when dispute evidence was created.

dispute_tokenstring uuid required

Dispute token evidence is attached to.

download_urlstring

URL to download evidence. Only shown when upload_status is UPLOADED.

filenamestring

File name of evidence. Recommended to give the dispute evidence a human-readable identifier.

tokenstring uuid required

Globally unique identifier.

upload_status'DELETED' | 'ERROR' | 'PENDING' | 'REJECTED' | 'UPLOADED' required

Upload status types:

DELETED - Evidence was deleted.
ERROR - Evidence upload failed.
PENDING - Evidence is pending upload.
REJECTED - Evidence was rejected.
UPLOADED - Evidence was uploaded.

upload_urlstring

URL to upload evidence. Only shown when upload_status is PENDING.

Example payload

{
  "created": "2023-07-19T18:39:34.768Z",
  "dispute_token": "f7a74167-d6d5-4f7d-8501-36df11ba371b",
  "token": "48b8e42c-a645-44f6-8604-20c3127e9008",
  "upload_status": "REJECTED"
}

Response

Return a 200 status to indicate that the data was received successfully