FI Management Operations

This interface is used to associate a local account ID with a specific FI, detach a local account ID from a specific FI, and change FI/global account properties

All operations described in this section are performed on HTTP GET request from UA to the URL IDP_API_BASE_URL/fi_ui.

The following input parameters must be specified:

• action_id. Operation identifier. Allowed values:

  associate. Associate ID of a current local account with an FI.

  detach. Detach a local account ID from FI.

  update. Change FI/global account properties.

• user_id. Local account ID.
• sp_id. SP identifier.
• redirect_url. URL to which UA is forwarded after performing the operation. Before forwarding a user, IdP adds the following arguments to this URL:
  • have_associated_fi. A flag specifying if a local account is associated with an FI. Allowed values: true or false.
  • associated_fi_name. Name of the associated FI. This argument may be omitted (even if have_associated_fi=true).
  • result_code. Status code of an operation. May be omitted if operation was successfully performed. If operation failed, this argument holds an error code. Application that received this code is expected to show an error message to a user.

    Allowed values:

    FIM_ERR_FORBIDDEN. A user is not allowed to perform an operation (for example, if a user is not authenticated by IdP).

    FIM_ERR_BAD_REQUEST. Incorrect request (for example, if a required parameter is missing).

    FIM_ERR_FAILED. Operation failed due to some IdP error (either internal or caused by incorrect parameters).

    FIM_OK. Operation succeeded.