APapaleo
Authorization

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

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

post/booking/v0-nsfw/authorizations/by-link

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/authorizations/by-link
  • Auth
    OAuth 2
    Implicit: https://identity.apaleo.com/connect/authorize
    Scopes: authorizations.manage, admin

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 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

returnUrlstring nullable

Website URL used for redirection after payment is completed using the payment link.

Example request

{
  "target": {
    "type": "Booking",
    "id": "KYKXKLWL",
    "propertyId": "MUC"
  },
  "expiresAt": "2026-11-01T15:13:47.1482244Z",
  "countryCode": "DE",
  "description": "Consumption authorization for the reservation",
  "payerEmail": "0chai@hemenal5.space",
  "returnUrl": "https://example.com/return",
  "amount": {
    "amount": 150,
    "currency": "EUR"
  }
}

Response

Authorization was created and will be processed

idstring required

Created authorization id

Example response

{
  "id": "HDQFGFOS"
}

Changes

No operation changes recorded.