Get Dispute Alert by ID
Retrieve a single pre-chargeback dispute alert by its ID.
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.
Path Parameters
Identifier of the resource in Payrails.
Response
Alert found.
ID of the enrollment that produced this alert.
The provider's identifier for this alert.
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 How the alert maps to a Payrails payment.
matched, unmatched, ambiguous, retrying Lifecycle state of the alert.
Received, Resolved, Declined, WillExpire, Expired, ActionFailed, RefundInitiated The workspace of the matched payment; absent until the alert is matched.
When the provider created the alert.
Broad category derived from program. PreChargeback covers actionable programmes (Ethoca, CDRN, RDR). FraudReport covers reporting-only programmes (SAFE, TC40, TC15).
PreChargeback, FraudReport Provider-specific alert type. Open-ended (not a fixed enum); Chargeblast documents FRAUD and DISPUTE as known values but does not guarantee an exhaustive list.
The acquiring BIN an RDR alert was routed on, taken verbatim from the provider webhook. Distinct from cardBIN, which is the issuer BIN derived from the cardholder PAN. Populated for RDR only; null for every other program.
The acquirer's card acceptor ID for an RDR alert, paired with acquirerBIN. Populated for RDR only; null for every other program.
The card network, normalized to the canonical Payrails value (commondto.CardNetwork — e.g. visa, mastercard, amex, discover, jcb), matching the payment instrument's network. Null when the provider's brand could not be classified.
The merchant descriptor carried on the alert.
Acquirer Reference Number used to match the alert to a payment.
When the alert's action window closes, derived from the provider's near-expiry notification. Null until that notification is received.
The matched Payrails payment, when the alert resolved to a single payment.
The distinct payments the matcher found when it declared the alert ambiguous. Present only while matchState is ambiguous; pick one and submit it to the manual match endpoint to resolve the alert.
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.
Resolved, AlreadyRefunded, AlreadyChargeback, Ineligible, MIDLost, NotMyDescriptor, EscalateChargeback, TDS, UnmatchedCannotFindTransaction 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 How the alert was actioned (e.g. portal).
The user who actioned the alert, when actioned by a portal user.
The dispute this alert is linked to, when a chargeback followed.
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.