Get Dispute Alert by ID
Retrieve a single pre-chargeback dispute alert by its ID.
Path parameters
Identifier of the resource in Payrails.
Response
Alert found.
The workspace of the matched payment; absent until the alert is matched.
ID of the enrollment that produced this alert.
The provider's identifier for this alert.
When the provider created the alert.
The network program that issued the alert. Unknown is a forward-compatible sentinel for a program Payrails does not yet have a canonical value for.
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 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.
How the alert maps to a Payrails payment.
Lifecycle state of 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.
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].
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.
Example response
{
"amount": {
"value": "12.50",
"currency": "EUR"
}
}