Skip to main content
POST
Action a Dispute Alert

Authorizations

Authorization
string
header
required

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.

Headers

x-idempotency-key
string<uuid>
required

Idempotency key to be used. Sending again the same key would return the same result without re-executing the update.

Path Parameters

alertId
string<uuid>
required

Identifier of the resource in Payrails.

Body

application/json
result
enum<string>
required

The merchant's chosen outcome for the alert, submitted to the provider.

Available options:
Resolved,
AlreadyRefunded,
AlreadyChargeback,
Ineligible,
MIDLost,
NotMyDescriptor,
EscalateChargeback,
TDS,
UnmatchedCannotFindTransaction
notes
string

Optional free-text note recorded with the action.

Response

Alert actioned successfully.

Last modified on October 9, 2026