Currency
This screen provides currency selection within the Edit Account flow. It returns the selected currency code after the user confirms the selection.
This screen includes:
- Modal interface for selecting a currency.
- Search field that filters currencies by name, symbol, or ISO code.
- Scrollable list of supported currencies.
- Currency rows that display the currency name with symbol or ISO code.
- Highlight state that indicates the selected currency.
- Row selection that updates the pending currency value.
- Header close control that dismisses the modal without applying changes.
- Cancel action that exits without updating the currency.
- Save action that applies the selected currency to the current context.
Workflow
- Open Account in the SDK navigation.
- Select Currency in the Settings section.
- The SDK opens the Currency selection modal with the supported currency list and marks the current value.
- Search or scroll to locate the required currency.
- Select a currency row to update the pending selection.
- Select Save to return the selected currency code to the host application.
Validations
| Scenario | App Behavior | SDK Output |
|---|---|---|
| Currency list is empty. | Displays an empty state and disables selection. | Returns an empty currency list. |
| Search query returns no results. | Displays an empty list. | Returns a filtered result with no matches. |
| Session is not active. | Blocks access and redirects to login. | Returns an unauthenticated state. |
| Selected currency is unsupported. | Prevents saving the selection. | Returns a validation error for the currency code. |
Actions
| Scenario | App Behavior | SDK Output |
|---|---|---|
| Currency selector opens. | The modal displays the currency list with the current value highlighted. | Returns the supported currencies and the active currency code. |
| A currency row is selected. | The selected value becomes the pending currency. | Returns the selected currency code in the screen state. |
| Save is selected. | The modal closes and the selected currency becomes active. | Returns the updated currency code. |
| Cancel is selected or the modal closes. | The modal closes and keeps the existing currency. | Returns no currency update. |