Skip to main content

Hotels

There are two different ways a hotel takes payments with MONEI. Which one applies depends on whether you are a hotelier or the company building the software.

  • Your PMS or booking platform already integrates MONEI. Several hotel platforms are MONEI Connect partners — Hotelgest among them — so if you run one of them you accept MONEI payments through it, with no development on your side. Ask your platform to switch MONEI on for your property.
  • You build the integration yourself. If you develop the hotel's software, this page's API tokenizes card data pulled from a channel manager, so raw card numbers never reach your system.

The rest of this page covers the second case.

Channel manager tokenization​

MONEI integrates with hotel channel managers to securely payment card information from booking reservations. Card data is received, tokenized, and tokens are returned for secure payment processing — your system never handles raw card numbers.

How it works​

  1. Your backend sends a tokenization request specifying the channel manager
  2. MONEI retrieves card information from the channel manager as a PCI-compliant intermediary
  3. Card data is tokenized — raw card numbers are never exposed to your system
  4. Tokens are returned for use in payment creation

Authentication​

Add your MONEI API Key to the request header:

Authorization: YOUR_API_KEY

Endpoint​

URL: https://api.monei.com/v1/partner/tokens

Method: POST

Common parameters​

ParameterTypeRequiredDescription
accountIdStringYesYour MONEI account ID (UUID)
sessionIdStringYesA UUID identifying the session
channelManagerTypeStringYesSITEMINDER or CHANNEX

Additional parameters vary by channel manager — see the specific integration guides below.

Test Mode​

Enable test mode in your MONEI dashboard to use Siteminder and Channex preprod URLs during development.

Supported Channel Managers​

Channel ManagerResponse FormatDocumentation
SiteminderXML (SOAP)Integration guide
ChannexJSONIntegration guide

Before you begin​

  1. Create a MONEI account.
  2. Get your MONEI API Key.
  3. See the Siteminder or Channex integration guide for channel-specific setup.

Common questions​

Can I use MONEI with Hotelgest?​

Yes. Hotelgest is a MONEI Connect partner, so a hotel running Hotelgest as its PMS can accept MONEI payments through it. You don't integrate anything yourself — ask Hotelgest to enable MONEI for your property.

Hotelgest is not one of the channel managers in the tokenization API above; that API is a separate, developer-facing feature and currently supports Siteminder and Channex.

My PMS isn't listed. Can I still use MONEI?​

Often, yes. The list above is only the channel managers the tokenization API reads cards from, and the partner list is a sample rather than every platform. If your PMS or booking engine isn't named, ask them whether they support MONEI — and if they'd like to, MONEI Connect is how a platform offers MONEI payments to the hotels it serves.