v1

latestOpenAPI 3.0.22026-07-2667277423.4 KB
Chargebacks

Chargeback: Show

Retrieves the details of a single chargeback request, including its timeline, payment, customer, and defense (if one exists).

This endpoint is only available to merchants with the chargeback feature enabled; otherwise it returns 404 Not Found.

get/chargeback_requests/{id}

Path parameters

idstring required

A unique 25-character alphanumeric resource identifier.

The chargeback request UUID.

Response

200 response

idstring required

A unique 25-character alphanumeric resource identifier.

status'pending' | 'accepted' | 'cancelled' | 'expired' | 'defended' | 'lost' required

Current status of a chargeback request.

reason_codestring required

Machine-readable reason code. Internal codes (e.g. "CB_Fraud") are used by default; for Worldpay Visa/Mastercard payments the network's own reason codes are used instead (e.g. "10.4" or "4837").

reasonstring required

Human-readable chargeback reason corresponding to the reason code.

created_atstring date-time required

Timestamp when the chargeback was created.

due_datestring date-time required

Deadline by which the merchant must respond.

last_updated_atstring date-time required

Timestamp when the chargeback was last updated.

Example response

{
  "reason_code": "CB_Fraud",
  "payment": {
    "currency": "JPY"
  }
}