---
created: 2024-07-10T11:11
updated: 2024-07-30T11:11
author: Florian Klein
title: Kiosk payment
---
# Kiosk payment (reservation based)

With the introduction of the Folio structure in ibelsa 2023, it became important to make payments on an invoice basis and no longer on a reservation basis.
However, as it is easier for many partners to work on a reservation basis, we have now introduced new endpoints that take over the handling of invoices for the partner.

## Receive the amount to be paid for a room reservation

The amount to be paid for a room reservation can be determined via the following end point:

[Get open amount to pay for roomreservation](/api/doc#get--api-kiosk-invoicedata-{roomres_id})

Example response:

```json
{
    "success": true,
    "totalCount": 2,
    "data": {
        "open_sum": "1450.00",
        "invoice_data": [
            {
                "invoice_id": 26171520,
                "folio_uuid": "beab7003-fbc3-4cfe-85e5-ed275e9c151f",
                "belongs_to_reservation": "13136820",
                "closed": false,
                "invoice_items": [
                    {
                        "id": 165367999,
                        "parent_id": null,
                        "name": "Zimmer  #203 - V, Nancy 09.09.2023 - 14.09.2023",
                        "price": "128",
                        "price_with_children": "200.00"
                    },
                    ...more items...
                ],
                "items_sum": "1450.00",
                "folio_payments": [],
                "payments_sum": "0.00",
                "open_sum": "1450.00"
            }
        ]
    }
}
```

The amount to be paid can be found in the 'open_sum' field.
In the 'invoice_data' field, additional information can be found on how the amount is made up.

**This is how the amount to be paid is calculated:**

The room reservation must pay all open invoices that are assigned to it and all open invoices belonging to the main reservation that are not assigned to a room reservation.
This means that the first room reservation for which the payment is made pays all additional costs and if the main reservation is not marked as self-paying, this room reservation must pay the costs of all rooms in the main reservation.

## Paying the open amount

The amount can then be paid via the following endpoint:

[Pay open amount for roomreservation](/api/doc#post--api-kiosk-pay-{roomres_id})

As an additional security measure, the amount must be provided again here.