Authorization

Creates a link to a payment form that allows guests to complete the authorization

<br>You must have this scope: 'authorizations.manage'.

post/booking/v1/authorizations/by-link

Headers

Idempotency-Keystring

Unique key for safely retrying requests without accidentally performing the same operation twice. We'll always send back the same response for requests made with the same key, and keys can't be reused with different request parameters. Keys expire after 24 hours.

Request body

expiresAtstring date-time required

The date that the link expires<br />A date and time (without fractional second part) in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>

countryCodestring required

The payer's country code

descriptionstring nullable

Authorization description. It will be shown on the payment form of the link

payerEmailstring nullable

The email address of the payer or cardholder. It can be used to verify the identity of the payer and allow to catch a fraudulent usage of the payment account if the email address does not match the one on file at the bank

Example request

{
  "target": {
    "type": "Booking",
    "id": "KYKXKLWL",
    "propertyId": "MUC"
  },
  "expiresAt": "2026-09-03T21:18:40.894436Z",
  "countryCode": "DE",
  "description": "Consumption authorization for the reservation",
  "payerEmail": "0chai@hemenal5.space",
  "amount": {
    "amount": 150,
    "currency": "EUR"
  }
}

Response

Authorization was created and will be processed

idstring required

Created authorization id

Example response

{
  "id": "HDQFGFOS"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.