Managing OTP and refreshing an item

Presentation

For some bank accounts, the user will need to go through a multi-factor authentication to add a new item or to refresh it. This kind of security is called a Strong Customer Authentication (SCA).

Each time you need to refresh an item with a One Time Password or a Strong Customer Authentication you should call Manage OTP and Sync.

This endpoint returns an URL pointing to the Connect funnel to refresh an item. If needed, the User will be able to fill the OTP he received from the bank.

How to know if the bank account needs a refresh with OTP ?
The Item concerned will have a specific status : 1010.

Example

curl "https://sync.bankin.com/v2/connect/items/sync/url?client_id=MY_CLIENT_ID&client_secret=MY_CLIENT_SECRET&item_id=ITEM_ID" \
     -H GET \
     -H 'Bankin-Version: 2018-06-15' \
     -H 'Authorization: Bearer TOP_SECRET_ACCESS_TOKEN'

{
  "redirect_url": "https://connect.bridgeapi.io?feature=sync&item=ITEM_ID&token_uuid=SECURE_ACCESS_TOKEN"
}