# Siteminder

[Siteminder](https://www.siteminder.com/) is a widely used channel management system. MONEI acts as a [proxy for Siteminder](https://siteminder.atlassian.net/wiki/spaces/PMSXCHANGEV2/pages/1875838050/PMS+Tokenization+in+SiteMinder), returning the same response you'd get from Siteminder directly, with an additional `<MoneiResponse>` field containing the payment token.

## Request[​](#request "Direct link to Request")

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

```
{

  "accountId": "<monei_account_id>",

  "hotelCode": "<hotel_code>",

  "sessionId": "<uuid4>",

  "channelManagerType": "SITEMINDER",

  "siteminderName": "<siteminder_name>",

  "username": "<username>",

  "password": "<password>",

  "echoToken": "<uuid4>"

}
```

### Parameters[​](#parameters "Direct link to Parameters")

| Parameter            | Type   | Required | Description                                                                   |
| -------------------- | ------ | -------- | ----------------------------------------------------------------------------- |
| `accountId`          | String | Yes      | Your MONEI account ID (UUID) — the account the payment will be transferred to |
| `hotelCode`          | String | Yes      | Hotel identifier — provided by Siteminder                                     |
| `sessionId`          | String | Yes      | UUID identifying the session                                                  |
| `channelManagerType` | String | Yes      | Must be `SITEMINDER`                                                          |
| `siteminderName`     | String | Yes      | Your Siteminder account name                                                  |
| `username`           | String | Yes      | Authentication username — provided by Siteminder                              |
| `password`           | String | Yes      | Authentication password — provided by Siteminder                              |
| `echoToken`          | String | Yes      | UUID for request tracking — returned as `EchoToken` in the response           |

## Response[​](#response "Direct link to Response")

The response is a SOAP XML envelope matching the standard Siteminder format, with the `<MoneiResponse>` element added inside each reservation:

```
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

    <SOAP-ENV:Header />

    <SOAP-ENV:Body>

        <OTA_ResRetrieveRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0"

            TimeStamp="2024-01-17T11:38:03+00:00" EchoToken="uuid4">

            <Success />

            <ReservationsList>

                <HotelReservation CreateDateTime="2024-01-16T16:47:07+00:00" ResStatus="Book">

                        <!--

                        All the siteminder response

                        <POS>

                        <RoomStays>

                        <ResGuests>

                        ... -->

                        <MoneiResponse>

                            <payment_token>298b7c3bc2951ca0513e0e07d495b33ddf29d7ae</payment_token>

                            <expiration>1843430400</expiration>

                            <type>credit</type>

                            <last4>4414</last4>

                            <brand>MC</brand>

                            <cardHolderName>Joan Sanfeliu</cardHolderName>

                        </MoneiResponse>

                    </ResGlobalInfo>

                </HotelReservation>

            </ReservationsList>

        </OTA_ResRetrieveRS>

    </SOAP-ENV:Body>

</SOAP-ENV:Envelope>
```

### MoneiResponse Fields[​](#moneiresponse-fields "Direct link to MoneiResponse Fields")

| Field            | Description                                                                                                                                   |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `payment_token`  | MONEI token for the booking's card. Use in [payment creation](https://docs.monei.com/apis/rest/payments-create/.md) instead of raw card data. |
| `expiration`     | Token expiration date (Unix timestamp)                                                                                                        |
| `type`           | Payment method type (e.g. `credit`)                                                                                                           |
| `last4`          | Last four digits of the card number                                                                                                           |
| `brand`          | Card network (e.g. `MC` for Mastercard, `VISA`)                                                                                               |
| `cardHolderName` | Name of the cardholder                                                                                                                        |