> For the complete documentation index, see [llms.txt](https://wallee.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wallee.gitbook.io/documentation/payments/integrations/plugins/hospitality-plugins/hosted-opi-opi-on-premise.md).

# Hosted OPI / OPI on Premise

### Overview

This guide explains how to provision and configure the **Oracle OPI On-Premise (OPI OnPrem) and hosted OPI** setup with Oracle. It covers certificate installation, PSP chain code setup, and OPI interface configuration for both token exchange and payment processing.

### Provisioning

These are the details of the gateway that must be provisioned:

* **Interface ID**:\
  IFC\_OPI\_CLOUD\_OPI\_PLUGIN\_WALLEE\_GROUP
* **Specific Interface**:\
  Oracle Hospitality OPERA EFT Interface for WALLEE OPI PLUGIN by Wallee Group AG

### Certificates

In order to communicate with the API host you need the certificate and a password that is provided by our support team.

#### Root Certificate

Install the following root certificate. In order to get the Root certificate or the client certificate please get in touch with our Support in order to get the certificates and the corresponding passwords.

{% hint style="info" %}
Install the following client PFX.\
**Important**: Rename the file from `.p12` to `.pfx` before installation.
{% endhint %}

### Client certificate (PFX)

Install the client certificate to establish a secure connection.

1. Request the current PFX file from our [support team](https://wallee.com/ueber-wallee/support) — as stated above, the certificates and their passwords are issued by support.
2. Install it together with the password you receive with the file.

### PSP Chain Code

Ensure the following PSP chain code is set: **WALLEE**

### OPI Settings – Token Exchange

Please see below the settings for the token exchange tab. In the URl make sure you are copying the URL as listed below and the port is correctly set.

<figure><img src="https://231749824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFihtba0Cos9hcTFUfuK%2Fuploads%2Fgit-blob-f96fa51d030dd66866146c108cf64ca6d5d6286e%2FBildschirmfoto%202025-08-20%20um%2020.53.07.png?alt=media" alt=""><figcaption></figcaption></figure>

* **Host URL**: <https://hospitality.wallee.com/v1/opi/token>
* **Failover URL:** <https://hospitality.wallee.com/v1/opi/token>

### OPI Settings – Payment Interface

The communication with the wallee terminals are working through the cloud therefore its important tht the Communcation mode is set to **Middleware**

<figure><img src="https://231749824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFihtba0Cos9hcTFUfuK%2Fuploads%2Fgit-blob-db62a9f785011c45430e9c7033bb25f68053eb59%2FBildschirmfoto%202025-08-20%20um%2020.52.58.png?alt=media" alt=""><figcaption></figcaption></figure>

* **Mutual Authentication**: Enable (mandatory). Upload the certificate as well.
* **Inquiry Mode for Transaction Reversal**: Enable
* **Primary URL**: <https://hospitality.wallee.com/v1/opi/payment>
* **Failover Host:** <https://hospitality.wallee.com/v1/opi/payment>

### Related topics

* [Opera Cloud](/documentation/payments/integrations/plugins/hospitality-plugins/opera-cloud.md) — provisioning the Opera Cloud interface that uses this OPI setup.
* [Oracle Symphony](/documentation/payments/integrations/plugins/hospitality-plugins/oracle-symphony.md) — the Simphony POS integration, which uses the same certificates.