> ## Documentation Index
> Fetch the complete documentation index at: https://help.kwentra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kwentra Pay — Hyperpay Integration

> Connect your property to Hyperpay to generate SAR payment links directly from reservations and track all transactions — available for Saudi Arabia properties only. Business Value Enables Saudi prop...

Connect your property to Hyperpay to generate SAR payment links directly from reservations and track all transactions — available for Saudi Arabia properties only.

**Business Value**

* Enables Saudi properties to generate payment links directly from reservations — supporting MADA, Visa, and Mastercard.
* Automates guest payment collection: name, email, mobile, and amount are pulled from the reservation automatically.
* Successful payments are reflected back into the reservation automatically via webhook — no manual entry required.
* All Hyperpay transactions appear in the Kwentra Pay logs alongside other payment gateways for unified tracking.
* Multiple payment departments can be configured with different currencies and button labels for different use cases.

**Use Cases**

* Front desk sends a payment link to a guest's mobile or email directly from the reservation for an advance deposit.
* Accounts team searches the Kwentra Pay logs filtered by "Hyperpay" and "Details" to locate a specific transaction.
* Hotel admin sets up two payment cards — one for Front Office SAR collections, each linked to a different credit department.

**How It Works**

**1. Settings Screen**

**Where:** Front Office → Settings → Integrations → Kwentra Pay → Hyperpay

**Important:** The Hyperpay integration is only available for properties configured with Saudi Arabia as their country.

**Access Credentials**

| **Field**     | **Details**                                                                   |
| ------------- | ----------------------------------------------------------------------------- |
| Email Address | Mandatory. Your Hyperpay account email.                                       |
| Password      | Mandatory. Hidden — not returned from the database on page load for security. |

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/ff1c9f8b01.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=7db409edb2317e2c19d3cf66ef81271a" alt="" width="1916" height="420" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/ff1c9f8b01.png" />

**Payment Settings**

Use the **Add** button to configure one or more payment cards. Each card requires:

| **Field**          | **Details**                                                                                   |
| ------------------ | --------------------------------------------------------------------------------------------- |
| Payment Department | Dropdown — credit type departments only. Links payments to the correct accounting department. |
| Currency           | Auto-populated label based on the selected department's currency.                             |
| Button Label       | The text shown to users when initiating a Hyperpay payment (e.g., "Pay Now").                 |
| Allowed Modules    | Multiselect — select Front Office to show the payment option there.                           |

**Note:** If the selected department has no currency set, the system will prevent saving and show: "Cannot save the form as the department \[NAME] does not include a currency. Please set a default currency for the department or select a different department."

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/84096b5bcd.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=38553f81035c95a2e759534768c0ca07" alt="" width="1780" height="570" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/84096b5bcd.png" />

**Enabling the Integration**

1. Fill in Access Credentials and configure at least one Payment Settings card.
2. Click **Save**.
3. Click **Enable Integration**. The system calls Hyperpay to verify your credentials.
4. If successful: integration activates. If credentials are wrong: "Wrong Credentials — Data is not saved & integration is not enabled."

**Note:** Once enabled, the button label changes to "Disable Integration". Click it at any time to deactivate.

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/eec92e1b75.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=be4ea5db53e7b01cd7ec15cca3cea6fc" alt="" width="406" height="222" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/eec92e1b75.png" />

**2. Generating a Payment Link**

**Where:** Front Office → Individual Reservations → Billing → Tools Menu → Payment → kwentra Pay |  Front Office → Paymaster → Billing

When a payment is initiated via the Kwentra Pay button, Hyperpay automatically generates a payment link using the following data from the reservation:

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/8a00a5978e.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=45185be709454748c702fd39bf2509be" alt="" width="564" height="487" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/8a00a5978e.png" />

Choose kwentra Pay

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/8c1e86025c.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=c2dbc054bd9c0f277ea46439bf404193" alt="" width="830" height="302" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/8c1e86025c.png" />

Choose the payment department that will record the payment for the payment link, and add the amount for the reservation

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/be61b4d6ce.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=a3f3b184d91e9b0eb1d30c76300d2d13" alt="" width="843" height="623" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/be61b4d6ce.png" />

The generated link can be copied or sent directly via WhatsApp

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/dfd2f94ebb.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=b2e8911e647d3700518baaed57164196" alt="" width="749" height="559" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/dfd2f94ebb.png" />

Initial Payment Screen:

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/52104a6ef4.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=022a3fd59f4f959203c9d383be337c11" alt="" width="1251" height="899" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/52104a6ef4.png" />

Credit Card details

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/9db5724400.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=44cd192c539dddc9e11418de92cd8b7c" alt="" width="1652" height="678" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/9db5724400.png" />

| **Field Sent to Hyperpay** | **Source in Kwentra**                                           |
| -------------------------- | --------------------------------------------------------------- |
| Guest Name                 | Main Guest Profile — First Name + Last Name (or Paymaster name) |
| Email                      | Main Guest Profile → Email (defaults to placeholder if empty)   |
| Mobile                     | Main Guest Profile → Mobile (defaults to placeholder if empty)  |
| Amount                     | Total amount due on the reservation                             |
| Currency                   | Currency of the configured payment department                   |
| Language                   | Reservation language: Arabic → "ar", English → "en" (default)   |
| Payment Type               | Always "DB" (debit)                                             |

The generated link supports **MADA, Visa, and Mastercard**. The guest opens the link and completes payment. Once paid, Hyperpay sends a webhook and the payment is automatically recorded in the reservation.

**Note:** If the guest has no email or mobile on file, the system sends a placeholder value — this is required by the Hyperpay API and does not affect payment processing.

**3. Transaction Logs**

**Where:** Front Office → Settings → Integrations → Kwentra Pay → Logs

All Hyperpay transactions are recorded in the Kwentra Pay logs. Updates to the logs screen include:

* **Payment Gateway Name** — now a multiselect filter. Select "Hyperpay" to view only Hyperpay transactions.
* **Details column** — now visible in the logs table, showing transaction-specific data returned from Hyperpay.
* **Details filter** — search and filter log entries by any string within the Details field.
  <img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/5dcacaf8f6.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=1376efb12b11e1a171b90aae68db3071" alt="" width="1781" height="823" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/5dcacaf8f6.png" />
