Accounting Period Closure1

AdministrationAmenities2

Administrations2

AgeGroups2

AgendaPeriods8

AggregatedJournalTransactions1

Agreement PeriodicCosts2

Agreements5

Amenities3

AmenityGroups2

App Availabilities1

App Supported Payment Methods1

Availabilities1

Booking Customer1

Bookings5

Brands2

Categories7

Category Availability1

Category CategoryAmenities3

Category Costs1

Category Extras1

Category Images3

Category LOSPrices1

Category NightPrices1

Channel Bookings4

Channel Channels2

Channel Costs2

Channel ExtraPackages2

Channel Extras2

Channel PrimaryPackages2

Channel RentableTypes2

Channel Reservations7

Channel Security Deposit Policies2

Channels5

CheckoutPortal Bookings2

CheckoutPortal Reservations2

Contact Search1

Contacts3

Contractors2

Conversation messages4

Conversations2

Costs2

Costs Channels1

Costs RentableTypes2

CustomerLoginRequests1

Customers6

DAC7 Reports4

Debtors1

DiscountActions7

DiscountCampaigns2

DiscountCards2

Domains2

Executors2

ExtraPackages2

Extras2

Extras RentableTypes1

Facilities2

Guests2

InternalMessages1

InventoryObject Images3

InventoryObject MeterReadings2

InventoryObjects9

Invoice PeppolDeliveries3

Invoice Signatures1

Invoices3

JournalTransactions1

Labels4

LedgerAccount JournalTransactions1

LedgerAccounts2

MasterPriceList ComplexPrices1

MasterPriceList SimplePrices1

MasterPriceLists4

Measurers2

MeterTypes2

Night Registry1

Orders2

Organizations1

Owners4

Payment Batches3

PaymentHandlers5

PaymentMethods4

PaymentRequest Chargebacks1

PaymentRequests2

PaymentResults1

Payments3

PeriodicCosts2

Periods5

PrimaryPackage Categories1

PrimaryPackage RentableTypes1

PrimaryPackages2

Promotions2

Receipt Signatures1

Receipts2

RefundResults1

Registers3

RentableIdentities5

Rentables10

RentableSegments2

RentableType Availabilities1

RentableType Costs1

RentableType Extras1

RentableType Images3

RentableType LOSPrices1

RentableType NightPrices1

RentableType RentableTypeAmenities3

RentableType Security Deposit Policies1

RentableTypes5

Reservation ChangeRequests2

Reservation Extra Packages1

Reservation ExtraOrderItems2

Reservation Guests5

Reservation Memos1

Reservation Messages1

ReservationPreviews1

Reservations8

ReviewForm Reviews1

ReviewForms2

Reviews3

Security Deposit Policies RentableTypes1

SpecialPeriods2

Subdomains2

Subscriptions2

Supplier RentableTypes5

Supplier Reservations2

Supplier Suppliers4

Suppliers3

TaskCosts5

Todo Timesheets5

Todo TodoImages4

Todo UsedMaterials5

TodoLists5

Todos5

TrafficSources2

Users2

VATCodes2

Vouchers3

Payments

POST payment

Changed on Nov 3, 2026

Create a new payment for an invoice. Note This should not be used by PSPs apps. Create a PaymentResult instead.

post/v3/administrations/{administration_id}/payments

Request

Base URL
https://api.bookingexperts.com
Auth
- API key in header X-API-KEY
- or OAuth 2
  Authorization code/oauth/authorize
  Token URL/oauth/token
TypeScript
https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/docs/v3/administrations/:administration_id/payments/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

administration_idstring required

Administration ID

Query parameters

fields[payment]string

Fieldset. Specify a comma separated list of attributes to return

includestring

Includes list. Specify a comma separated list of resources to include.

send_notificationboolean

Send a notification to the customer after creation

Headers

Accept-Languagestring

Supported languages. A comma separated list with one or more of the following locales: cs, da-DK, de, de-AT, de-CH, en-US, en-GB, es, fr, fr-BE, fr-LU, it, nb, nl, nl-BE, pl, pt, tr, en, da. Default: 'en'.

Request body

Example request

{
  "data": {
    "type": "payment",
    "relationships": {
      "payment_method": {
        "data": {
          "type": "payment_method"
        }
      },
      "booking": {
        "data": {
          "type": "booking"
        }
      },
      "invoice": {
        "data": {
          "type": "invoice"
        }
      },
      "register": {
        "data": {
          "type": "register"
        }
      }
    }
  },
  "included": [
    {
      "id": "1",
      "type": "payment_method",
      "relationships": {
        "logos": {
          "data": [
            {
              "type": "logo"
            }
          ]
        },
        "administration": {
          "data": {
            "type": "administration"
          }
        }
      }
    }
  ]
}

Response

PaymentResponse

Example response

{
  "data": {
    "id": "1",
    "type": "payment",
    "relationships": {
      "payment_method": {
        "data": {
          "type": "payment_method"
        }
      },
      "booking": {
        "data": {
          "type": "booking"
        }
      },
      "invoice": {
        "data": {
          "type": "invoice"
        }
      },
      "register": {
        "data": {
          "type": "register"
        }
      },
      "administration": {
        "data": {
          "type": "administration"
        }
      },
      "receipt": {
        "data": {
          "type": "receipt"
        }
      },
      "settled_with": {
        "data": {
          "type": "payment"
        }
      }
    }
  },
  "included": [
    {
      "id": "1",
      "type": "payment_method",
      "relationships": {
        "logos": {
          "data": [
            {
              "type": "logo"
            }
          ]
        },
        "administration": {
          "data": {
            "type": "administration"
          }
        }
      }
    }
  ]
}

Changes

Nov 3, 2026ff81bc4fefa9 Revision changes
- warning
  added the new da-DK enum value to the /////// response property for the response status
- warning
  added the new en-GB enum value to the /////// response property for the response status
- warning
  added the new en-US enum value to the /////// response property for the response status
- warning
  added the new external_voucher enum value to the /////// response property for the response status
- info
  added the new optional request property ///////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new optional request property ////////
- info
  added the new da-DK enum value to the request property ///////
- info
  added the new en-GB enum value to the request property ///////
- info
  added the new en-US enum value to the request property ///////
- info
  added the new external_voucher enum value to the request property ///////
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status

Operation history