Skip to main content

Renew Policy

Use the Renew Policy service to open an insurer-provided renewal channel.

Renewal completes outside the application.



This screen includes:

#ElementDescription
1Services headerDisplays available policy services
2Service listDisplays insurer-supported actions
3Renew Policy actionOpens the insurer renewal channel
4Additional service actionsDisplays additional insurer services when available
5Bottom navigationDisplays primary application navigation

Workflow​

  1. Open Services.
  2. Render available insurer services.
  3. Select Renew Policy.
  4. Retrieve the renewal URL.
  5. Open the external renewal channel.
  6. Complete renewal outside the application.
  7. Return to the app and update coverage when required.

Renewal Behavior​

ScenarioBehavior
Renewal supportedDisplay renewal action
Renewal unsupportedHide renewal action
Renewal URL availableOpen external channel
Renewal URL invalidBlock navigation

Validations​

ScenarioApp BehaviorSDK Output
Renewal unsupportedHide renewal actionrenewal = unavailable
Renewal URL invalidBlock navigationerror = invalid_url
Policy ineligible for renewalHide renewal actionpolicy = ineligible
External channel unavailableDisplay error stateerror = channel_unavailable

Actions​

ScenarioApp BehaviorSDK Output
Services openedLoad available servicesservices = loaded
Renew Policy selectedOpen renewal channelrenewal = opened
External channel openedTransfer to insurer flownavigation = external
User returns to appRestore previous statestate = resumed
Renewal unavailableDisplay error statestate = error

Endpoint Resources​

Process Renew Policy​

PATCH 

v3/services/renew-policy

Renews the user's policy.