# Access the app web interface

Learn how to access the web interface for the Stripe app for Oracle Opera.

After you finish configuring the app, you can access the web interface by doing the following:

1. Go to <https://127.0.0.1:8081>.
2. In the dashboard, enter your admin username and password.
3. Click **Sign In**.

## Manage web interface users 

When you first log in to the [dashboard](https://127.0.0.1:8081), you use the default admin user and password. The admin user can change the merchant secret key and create other super admin users, so controlling access to this account is necessary to ensure a secure operating environment.

### Change the password for the default admin user

We recommend changing the password for the default admin user and storing it in a secure password vault.

To do so, go to **Account** > **My Account**. Enter a new password and your current password, and then click **Save**.

Your new password must meet the following requirements:

- Include at least one numeric character (`0` to `9`).
- Be a minimum of six characters in length.
- Contain at least one lowercase letter.
- Contain at least one uppercase letter.
- Contain at least one non-alphanumeric character (`!@#$%^&*()[]{}<>:;.,~_-+=|\?/"'`).

### Create a super admin user

A super admin user has permission to set merchant private keys and related private read-only information. This user can also configure all user accounts, including merchants and devices.

1. In the [dashboard](https://127.0.0.1:8081), click **Settings** > **User Management**.
2. On the **User Management** page, click **Add New**.
3. On the **Add new user** page, do the following:
   - Provide the relevant details.
   - Select all permissions.
   - Click **Save**.

### Create a configuration user

A configuration user has permission to add users (except super admins), readers, and workstations, and perform all other non-super admin actions.

1. In the [dashboard](https://127.0.0.1:8081), click **Settings** > **User Management**.
2. On the **User Management** page, click **Add New**.
3. On the **Add new user** page, do the following:
   - Provide the relevant details.
   - For **Permissions**, deselect **Merchant Management** and **User Management**.
   - Click **Save**.

> Don’t select the following permissions: **Merchant Management** and **User Management**. The secret key gets automatically added for the merchant, and the configuration user can create super admin users.

### Manage logged-in users

Users can manage their account settings or sign out of their account. In the [dashboard](https://127.0.0.1:8081), click **Account** and select either **My Account** or **Sign Out**.

## Manage Terminal readers 

The **Reader Management** page displays a list of reader devices with the following columns:

- Name
- Merchant
- Reader ID
- Workstation ID
- Actions

### Add readers to the app

1. On the Reader Management page, click **Add New**.
2. On the Add new reader page, provide the following details, and click **Save**.

| Field | Description | Source |
| --- | --- | --- |
| Merchant Account | The Stripe account ID in the format `acct_*********`. | Stripe |
| Name | The name of the reader. |  |
| Reader ID | The ID of the Stripe reader. | Stripe |
| Description | The description of the Stripe reader. |  |
| Serial Number | The serial number of the Stripe reader. | Stripe |
| Workstation ID | The ID of the Oracle workstation. | Oracle |

> Map workstations in Opera first, then copy the workstation names into the app’s dashboard on the **Reader Management** page. The Terminal ID in Opera and the Workstation ID in the app’s dashboard can be any value (up to 16 characters), but the two values must match exactly, or the app can’t route requests to the correct reader.

### Update or delete a reader

1. On the Reader Management page, locate the reader you want to update or delete.
2. Under **Actions**, select **Edit** or **Delete**.

## Manage merchants 

The Merchant Management page displays a list of merchants with the following columns:

- Name
- Merchant ID
- OPI Site ID
- Actions

### Add merchants to the app

1. On the Merchant Management page, click **Add New**.
2. On the Add new merchant page, provide the following details, and click **Save**.

| Field | Description | Source |
| --- | --- | --- |
| Merchant ID | The Stripe account ID in the format `acct_*********`. | Stripe |
| Name | The name of the merchant. |  |
| Secret Key | The API key for the Stripe account. Use a [restricted key](https://docs.stripe.com/keys-best-practices.md) scoped to the permissions the app needs (PaymentIntents, Refunds, PaymentMethods, SetupIntents, Transfers, Customers, Terminal, and read-only Account access) instead of your account’s full secret key. | Stripe |
| Merchant Display Name | The display name of the merchant. |  |
| Site ID | The Stripe chain code and your hotel’s property code, in the format `STRIPE|xxxxxx`. Obtain this value from Oracle. | Oracle |
| Merchant Address | The address of the merchant. |  |
| Stripe Connect Mode | If the merchant is in a Stripe Connect setup, select **Disabled**, **Destination Charges**, or **Direct Charges**. | Stripe |
| Connected Account ID | If you selected **Destination Charges** or **Direct Charges** for the Stripe connect mode, specify the Connect account ID. | Stripe |

### Update or delete a merchant

1. On the Merchant Management page, locate the merchant you want to update or delete.
2. Under **Actions**, select **Edit** or **Delete**.

> The app logs every change to a merchant’s secret key to a secret key log, including the operation date, merchant ID, and the username of the admin who made the change. Review this log periodically to confirm that only authorized admins are rolling merchant secret keys.

## View transactions 

The **Transactions** page displays a list of transactions the app has processed, with pagination and a search field for sequence numbers. Click a column header to sort by that column.

| Column | Description |
| --- | --- |
| Sr No | The transaction number. |
| Trans Date | The date of the transaction. |
| Trans Type | The type of transaction. |
| Sequence No | The order of the transaction request. |
| Payment Intent | The ID of the Stripe PaymentIntent associated with the transaction. |
| Charge | The ID of the Stripe charge associated with the transaction. |
| Action | Click **View** to see transaction details, including the Terminal ID and Trans Type. |

## See also

- [Troubleshoot the app](https://docs.stripe.com/use-stripe-apps/oracle/opera/troubleshooting.md)