Account Insurance Contract
Insurance attached to an account can be managed within our system.
Example of insurance can be Payment protection insurance.
Several insurance packages can be configured in order to describe the insurance fee calculation and the usage rules.
The list of authorized insurance events and their codes are also part of an insurance package.
As an example:
Event code | Description/Comment |
RSV | Payment protection insurance is active |
RAL | Ensured event "UNEMPLOYMENT" |
RAU | Ensured event "INCAPACITY FOR WORK" |
RTD | Ensured event "DEATH" |
RSS | Reversal of insurance |
RKK | Insurance Cancellation by the customer |
RKB | Insurance Cancellation by the bank |
RKA | Insurance Cancellation by the bank, automatically (maximum age reached) |
List Insurance Contracts For An Account
The API allows the list of insurance contracts for an account to be retrieved.
The main input fields requested by the API are:
- The issuer ID
- The account for which info is requested: It can be provided by using the account reference or the issuer external account reference.
In return, the list of insurance contracts is provided with the subscribed insurance package, the insurance events, the latest occurring events and the status for each contract.
The list of insurance events and their codes are pre-defined and configured in the insurance package.
The contracts with a closed status are not provided back.
The possible statuses of insurance contracts are:
- ACTIVE,
- INTERRUPTED,
- DISABLED,
- CLOSED
The statuses depends on the insurance events configuration.
API links
Retrieve An Insurance Contract For An Account
The API allows an insurance contract for an account to be retrieved.
The main input fields requested by the API are:
- The issuer ID
- The account for which info is requested: It can be provided by using the account reference or the issuer external account reference
- The insurance package reference
In return, the insured events and the latest occurring events for the account and insurance package reference are returned.
The list of insurance events and their codes are a pre-defined and configured in the insurance package.
The contracts with a closed status are not provided back.
The possible status of insurance contracts are:
- ACTIVE
- INTERRUPTED
- DISABLED
- CLOSED
The statuses depends on the insurance events configuration.
API links
Create An Insurance Contract For An Account
The API allows an insurance contract for an account to be activated if the activation was not requested at the contract creation.
The main input fields requested by the API are:
- The issuer ID
- The account for which info is requested: It can be provided by using the account reference or the issuer external account reference
- The insurance package reference
- The insurance event code for activation if the activation by default is not defined in the product setup
Controls are performed in our system in order to check that:
- The insurance package is authorized
- The event exists for the insurance package
- The event is associated to an event with “Activate Insurance” action
- If insurance Minimum eligible age is configured, account owner age should be >= Minimum eligible age
- If insurance Maximum eligible age is configured, account owner age should be <= Maximum eligible age
API links
Close An Insurance Contract
The API allows an insurance contract for an account to be closed.
The main input fields requested by the API are:
- The issuer ID
- The account for which info is requested: It can be provided by using the account reference or the issuer external account reference
- The insurance package identifier
API links
Add An Insurance Event To Insurance Contract
The API is used to post some events to an insurance contract.
The complete list of event is defined in the product setup.
The actions linked to the event can be:
- activate insurance
- deactivate insurance
- stop the fee calculation
The main input fields requested by the API are:
- The issuer ID
- The account for which info is requested: It can be provided by using the account reference or the issuer external account reference
- The insurance package identifier
API links