Skip to main content
POST
Refund 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.

Response

Refund initiated, or the alert resolved because the payment was already refunded.

result
enum<string>
required

Which branch the refund ran. RefundInitiated means a payment refund was started and the alert moved to RefundInitiated (it is finalized later by the refund settlement). AlreadyRefunded means the payment was already refunded, so no money moved and the alert was resolved directly.

Available options:
RefundInitiated,
AlreadyRefunded
Last modified on October 6, 2026