Changing PIN

The Flutter Plugin exposes changePin to allow the currently logged in user to change their PIN. The user is first required to provide their current PIN, before being allowed to create the new PIN. The required flow and their events are described below.

changePin Events

changePin Flow

The resulting flow to change your PIN will contain the following steps:

1. User starts the change PIN flow by calling Onegini.instance.userClient.changePin().
2. An OpenPinAuthenticationEvent event is broadcasted.
3. A user needs then to authenticate using the PIN's authentication acceptAuthenticationRequest function.
   1. If the PIN was invalid a NextAuthenticationAttemptEvent event will be broadcasted.
   2. If the PIN was valid, ClosePinAuthenticationEvent and OpenPinRegistrationEvent events will be broadcasted.
4. A user needs to register using a new PIN through the PIN's registration acceptAuthenticationRequest function.
   1. If the PIN was invalid a PinNotAllowedEvent event will be broadcasted.
   2. If the PIN was valid a ClosePinRegistrationEvent will be broadcaster after which the changePin function will resolve.

Example code to start the change PIN flow

await Onegini.instance.userClient
    .changePin()
    .catchError((error) {
        print("Pin change failed");
    });