Get Dispute Alert by ID
Retrieve a pre-chargeback dispute alert by ID with its program, amount, match state, and status, plus the outcome of any subscription cancellation.
Authorizations
You can use an OAuth2 JWT bearer token in the Authorization header of your API requests for supported endpoints: Authorization: Bearer <YOUR_JWT_HERE>.
These tokens are valid for 10 minutes and can be requested via the access token endpoint endpoint.
Response
Alert found.
The network program that issued the alert, taken from the provider webhook. Ethoca, CDRN, and RDR are actionable pre-chargeback programmes (the merchant can resolve or decline the alert). SAFE, TC40, and TC15 are fraud-reporting feeds — they are stored for reporting and analytics but cannot be actioned (attempting to action them returns 409). Unknown is a forward-compatible sentinel for a program Payrails does not yet have a canonical value for.
Ethoca, CDRN, RDR, SAFE, TC40, TC15, Discover, AMEX, JCB, Unknown The specific outcome the merchant selected when actioning the alert (the result from the action request). Persisted alongside the binary status. Null until the alert is successfully actioned. ResolvedCancelled is set only by the alert provider: it cancelled the transaction before capture, so no refund was needed.
Resolved, AlreadyRefunded, AlreadyChargeback, Ineligible, MIDLost, NotMyDescriptor, EscalateChargeback, TDS, UnmatchedCannotFindTransaction, ResolvedCancelled Merchant-facing status bucket, derived from status, matchState and outcome (computed server-side, not stored). Also accepted as a multi-select filter via filter[displayStatus].
Processing, ActionNeeded, Ignored, Refunded, Expired, Unrecognized, RefundInitiated Outcome of an automated billing-subscription cancellation for this alert. Present only when a cancellation was attempted; the key is omitted entirely — never sent as null — when no attempt was made, for example when the merchant has no billing provider configured or the feature is off.