# App settings and navigation

Learn how to navigate and manage settings in the Stripe app for Aptos One.

After you finish [configuring the app](https://docs.stripe.com/use-stripe-apps/aptos/aptos-one/configuration.md), you can manage Terminal settings, view logs, and update your configuration using the app’s navigation menu.

## Navigation menu 

Tap the menu icon (:menu:) to open the left navigation menu, which contains the following options:

| Menu item | Description |
| --- | --- |
| **Home** | Returns you to the main status screen, which shows your Stripe key configuration status, Terminal connection status, and current terminal mode. |
| **Terminal** | Opens the Terminal settings screen where you can update your Terminal ID, Location ID, and reader mode. |
| **Settings** > **Reset Keys** | Resets both your publishable key and restricted key. Use this option if you need to reconfigure your API keys. |
| **About** | Displays the current version of the Stripe app for Aptos One. |

## Terminal screen 

To update your Terminal configuration, tap **Terminal** from the navigation menu.

| Setting | Description |
| --- | --- |
| **Reader mode** (toggle) | Toggle between **Physical reader** mode and **Simulated reader** mode. Use simulated mode for testing without hardware. |
| **Terminal ID** | The ID of the physical Stripe Terminal reader that the app communicates with. You can find it in the [Stripe Dashboard](https://dashboard.stripe.com/terminal/readers). |
| **Location ID** | The location ID defined in Stripe that the Terminal reader belongs to. Required for physical reader mode. |

Use the following buttons to manage your Terminal configuration:

- **Save Configuration**: Saves the current Terminal settings.
- **Clear Terminal ID**: Clears the Terminal ID field.
- **Cancel**: Discards any changes and returns to the main screen.

## Settings screen 

To manage application settings, tap **Settings** from the navigation menu.

| Setting | Description |
| --- | --- |
| **Refund Polling Timeout** | Sets the number of seconds the app waits for linked refund updates before timing out. Increase this value if you see refund timeout errors. |
| **Log Retention** | Configures how many days the device keeps payment logs before older entries are automatically removed. |
| **View Logs** | Opens the payment log viewer. See [Logs](https://docs.stripe.com/use-stripe-apps/aptos/aptos-one/app-settings.md#logs) for more details. |

### Reset Keys

To reset your API keys, tap **Settings** > **Reset Keys**. This clears both your publishable key and restricted key from the device. After resetting them, you must re-enter your keys the next time the app launches.

## Logs 

The Stripe app for Aptos One (Payment Sidecar app) records all payment activity to a local log file for troubleshooting and auditing purposes.

| Property | Details |
| --- | --- |
| **Log file name** | `payment-results.txt` |
| **Storage location** | Stored locally on the device. On Android devices, the file is located in the **Downloads** folder. |
| **Retention** | Configurable from the **Settings** screen. Older entries are removed automatically based on the configured retention period. |

To view logs, navigate to **Settings** > **View Logs**, or access the `payment-results.txt` file directly from the device file system.

## Troubleshooting 

### Reader connection failures

If your Stripe Terminal reader can’t connect to the app:

- Verify that the Stripe Terminal reader and the device running the Aptos One SSA are connected to the **same Wi-Fi network**.
- Restart the reader and confirm its network connection before retrying.
- Make sure the reader is registered in the [Stripe Dashboard](https://dashboard.stripe.com/terminal/readers) and that the correct **Terminal ID** is entered in the app.

### Refund timeouts

If linked refunds time out before completing:

- Go to **Settings** and increase the **Refund Polling Timeout** value (measured in seconds).
- Adjust the value based on your typical refund processing time.

## See also

- [Configure the app](https://docs.stripe.com/use-stripe-apps/aptos/aptos-one/configuration.md)