App settings and navigation
Learn how to navigate and manage settings in the Stripe app for Aptos One.
After you finish configuring the app, you can manage Terminal settings, view logs, and update your configuration using the app’s navigation menu.
Navigation menu
Tap the menu icon () 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. |
| 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 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 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.