# 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)