5. Invoke

This API is used to trigger invoke on user’s lien marked assets.

Input Type

InputTypeDescription
finsire_idstringA valid id generated during user creation
order_idnumberA valid order number that can be fetched from ordering assets API response
loan_disbursedbooleanThis indicates whether the loan was disbursed. It acts as a confirmation from stakeholders to know if the loan was disbursed
invoke_reasonstringThis indicates the reason for invoke. It is an enum and accepts two options: DPD BREACED and INVOKE VALUE BREACHED
user_notification_statusbooleanThis indicates whether the user has been notified of the invoke and has given confirmation for the invoke to happen

Common error scenarios

The following are the common error scenarios in sending an API request:

ErrorDescription
param is missing or the value is empty: finsire_idfinsire_id is a required field
param is missing or the value is empty: emailemail is a required field
param is missing or the value is empty: otpotp is a required field
param is missing or the value is empty: order_idorder_id is a required field
param is missing or the value is empty: lienrefnolienrefno is a required field
param is missing or the value is empty: assetsassets is a required field

You can try out this API here.