APapaleo
AuthorizationActions

Fails the authorization

<br>You must have this scope: 'payments.admin'.<br>For fine-grained clients, you must have this permission: 'core.authorizations.modify'.

put/booking/v0-nsfw/authorization-actions/{authorizationId}/fail

Request

  • Base URL
    https://api.apaleo.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.apaleo.com/booking/v0-nsfw/authorization-actions/{authorizationId}/fail
  • Auth
    OAuth 2
    Implicit: https://identity.apaleo.com/connect/authorize
    Scopes: payments.admin, admin

Path parameters

authorizationIdstring required

The identifier of the authorization

Request body

reasonCode'Failed' | 'Expired' required

Reason code for the authorization failure.

failureReasonstring nullable

Textual description of the failure reason.

transactionIdstring nullable

Transaction Id of Authorization in the payment service payment transaction log. Required if transaction id already set for authorization.

expiredAtstring date-time nullable

The actual date and time of EXPIRE event. Required if Apaleo.Api.Modules.Booking.Models.Authorization.FailAuthorizationRequest.ReasonCode is Apaleo.Api.Modules.Booking.Models.Authorization.AuthorizationFailureReasonCode.Expired.<br />A date and time in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>

Example request

{
  "reasonCode": "Failed",
  "failureReason": "Authorization failed due to insufficient funds",
  "transactionId": "VT6G6BFUR6XE5MHZARAX2ODK7Y",
  "expiredAt": "2026-11-27T15:13:47.1874851Z"
}

Response

Success

Changes

No operation changes recorded.