Renew Policy
Use the Renew Policy service to redirect users to an insurer-provided renewal channel.
This service opens an external insurer website. Renewal is completed outside the Air Doctor application.
This screen includes:
- A Services header.
- A list of available insurer-provided services.
- A Renew policy option when supported.
- Additional service options such as View Claims, Submit a Claim, and Delayed Luggage, when available.
- A bottom navigation bar with primary application sections.
Workflow
- Open the Services section.
- The platform returns available services for the active policy.
- Select Renew Policy.
- The platform returns the renewal URL.
- Open the external renewal channel.
- Complete renewal outside the application.
- Return to the app and update coverage if required.
Post-Renewal Handling
The platform does not automatically update coverage after external renewal.
After completing renewal:
- The user must return to the application.
- The client may prompt for coverage update.
- The user can add or update coverage using the standard flow.
See Add Coverage.
Validations
These rules define renewal service availability and configuration constraints.
| Condition | App behavior | SDK output |
|---|---|---|
| Insurer does not support renewal. | Hide or disable the renewal option. | Service not included in response. |
| Renewal URL is missing or invalid. | Block navigation and display error. | Configuration error indicating invalid renewal endpoint. |
| Policy does not allow renewal services. | Hide the renewal option. | Service availability excluded from response. |
| External channel fails to load. | Display error message. | Error response indicating channel unavailable. |
Actions
These actions define behavior during the renewal flow.
| Condition | App behavior | SDK output |
|---|---|---|
| Load services. | Render available service options. | Response with service list and configuration. |
| Select Renew Policy. | Open external renewal channel. | Response includes renewal URL. |
| External site opens. | User completes renewal outside the app. | No synchronous SDK response. |
| User returns to app. | Resume application flow. | Session state unchanged unless coverage is updated. |
| Renewal channel unavailable. | Display error and block navigation. | Error response indicating channel unavailable. |