# 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](https://docs.monei.com/partners-connect/about/.md#who-uses-it) — **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[​](#channel-manager-tokenization "Direct link to Channel manager tokenization")

MONEI integrates with hotel channel managers to securely tokenize 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[​](#how-it-works "Direct link to 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](https://docs.monei.com/apis/rest/payments-create/.md)

## Authentication[​](#authentication "Direct link to Authentication")

Add your [MONEI API Key](https://dashboard.monei.com/settings/api) to the request header:

```
Authorization: YOUR_API_KEY
```

## Endpoint[​](#endpoint "Direct link to Endpoint")

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

**Method:** `POST`

## Common parameters[​](#common-parameters "Direct link to Common parameters")

| Parameter            | Type   | Required | Description                    |
| -------------------- | ------ | -------- | ------------------------------ |
| `accountId`          | String | Yes      | Your MONEI account ID (UUID)   |
| `sessionId`          | String | Yes      | A UUID identifying the session |
| `channelManagerType` | String | Yes      | `SITEMINDER` or `CHANNEX`      |

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

## Test Mode[​](#test-mode "Direct link to Test Mode")

Enable **test mode** in your [MONEI dashboard](https://dashboard.monei.com/) to use Siteminder and Channex preprod URLs during development.

## Supported Channel Managers[​](#supported-channel-managers "Direct link to Supported Channel Managers")

| Channel Manager                           | Response Format | Documentation                                                     |
| ----------------------------------------- | --------------- | ----------------------------------------------------------------- |
| [Siteminder](https://www.siteminder.com/) | XML (SOAP)      | [Integration guide](https://docs.monei.com/hotels/siteminder/.md) |
| [Channex](https://channex.io/)            | JSON            | [Integration guide](https://docs.monei.com/hotels/channex/.md)    |

## Before you begin[​](#before-you-begin "Direct link to Before you begin")

1. Create a [MONEI account](https://dashboard.monei.com/signup).
2. Get your [MONEI API Key](https://dashboard.monei.com/settings/api).
3. See the [Siteminder](https://docs.monei.com/hotels/siteminder/.md) or [Channex](https://docs.monei.com/hotels/channex/.md) integration guide for channel-specific setup.

## Common questions[​](#common-questions "Direct link to Common questions")

### Can I use MONEI with Hotelgest?[​](#hotelgest "Direct link to Can I use MONEI with Hotelgest?")

Yes. Hotelgest is a [MONEI Connect partner](https://docs.monei.com/partners-connect/about/.md#who-uses-it), 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](#supported-channel-managers) 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?[​](#other-pms "Direct link to 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](https://docs.monei.com/partners-connect/about/.md#who-uses-it) 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](https://docs.monei.com/partners-connect/about/.md) is how a platform offers MONEI payments to the hotels it serves.