Locker Account
This document describes the new endpoint that allows the creation of Locker accounts, exclusively linked to a regular account. The Locker account will have operational specifics, including rules for linking, creation, and closure.
Locker Account
Method: CreateLockerAccount
Introduction
The creation of the Locker account arises from the need to provide an efficient, secure, and practical solution for managing financial resources in various operations. As the financial market becomes increasingly dynamic and demanding, the Locker account was developed to offer clients the ability to isolate and control their financial transactions without compromising flexibility or compliance with Fitbank’s regulations.
The Locker account will be exclusively linked to a regular account, ensuring that all operations comply with the required regulatory standards. This linkage provides greater control and security while simplifying financial management for clients.
Benefits of the Locker Account:
- Isolate financial resources: The Locker account allows you to separate funds intended for specific goals, such as saving for a project, purchasing property, or creating an emergency fund. This provides better control over your resources and ensures the money is used efficiently.
- Increased security: By keeping funds isolated in a Locker account linked to a regular account, the client reduces the risk of confusion or misuse of resources. This offers an extra layer of financial protection.
- Ease of control: There’s no need to create new bank accounts. The Locker account can be linked to your regular account, making financial management simpler, centralized, and more efficient.
- Transaction transparency: All transactions made within the Locker account are recorded and monitored, ensuring complete visibility over the funds and how they’re used.
Examples of Use:
- Project Fund Management: If a client is planning to purchase a property, they can create a Locker account named “Real Estate Purchase” to separate funds intended for that specific project. This allows for detailed control and guarantees that the money will be used for the intended purpose.
- Savings and Financial Planning: The Locker account can also be used as a form of savings, where the client can set aside a portion of their resources for long-term goals, while keeping the rest in their regular account for daily expenses.
This solution was designed to meet various needs, offering clients the flexibility to move funds efficiently, but in a secure and regulated manner. The Locker account eliminates the complexity of creating independent new accounts, providing a simplified and practical approach, ideal for those seeking financial organization and control over their operations.
Locker Account Specifications
- Linking: Each Locker account must be linked to a single regular account, meaning the account must be properly regulated according to Fitbank's standards.
- Linking Limit: A regular account can link multiple Locker accounts, but each Locker account can only be linked to one regular account.
Endpoint Structure for Locker Account Creation
Request Parameters:
{
"Method": "CreateLockerAccount",
"PartnerId": 1358,
"BusinessUnitId": 359,
"RegularAccount": {
"AccountKey": "465628-254444-1984604-2",
"Bank": 565,
"BankBranch": 5435,
"BankAccount": 54545,
"BankAccountDigit": 54545
},
"LockerAccount": {
"LockerNickName": "Real Estate Purchase",
"Bank": 1236,
"BankBranch": 339454988,
"BankAccount": 1,
"BankAccountDigit": 3
}
}
Method CreateLockerAccount Field Specifications
Below are the descriptions of the fields used in the CreateLockerAccount method. Each field is detailed to ensure the developer knows exactly how to use the required data when making the API request.
Parameter | Description | Mandatory | Type | Comments |
---|---|---|---|---|
Method | Method To Be Used | Yes | String | |
PartnerId | Information provided by FitBank | Yes | INT | |
BusinessUnitID | Information provided by FitBank | Yes | INT | |
RegularAccount | Information of the regular account linked to the Locker account. Contains the following details: | Yes | Object | |
RegularAccount.AccountKey | The key of the regular account. | Yes | String | |
RegularAccount.Bank | The bank code for the regular account. | Yes | INT | |
RegularAccount.BankBranch | The branch code of the regular account’s bank. | Yes | INT | |
RegularAccount.BankAccount | The account number of the regular account. | Yes | INT | |
RegularAccount.BankAccountDigit | The account digit of the regular account. | Yes | INT | |
LockerAccount | Information of the Locker account to be created. Contains the following details: | Yes | Object | |
LockerAccount.LockerNickName | A nickname for the Locker account, used to identify the purpose of the account. | Yes | String | |
LockerAccount.Bank | The bank code for the Locker account. | Yes | ||
LockerAccount.BankBranch | The branch code for the Locker account’s bank. | Yes | ||
LockerAccount.BankAccount | The account number for the Locker account. | Yes | ||
LockerAccount.BankAccountDigit | The account digit for the Locker account. | Yes |
Locker Account Closure
The CloseAccount method will be adapted to allow the closure of Locker accounts, with the following conditions:
- Verification of Remaining Balance:
Behavior: If there is any remaining balance in the Locker account, closure will not be allowed. The error message returned will be:
Behavior: If there is any remaining balance in the Locker account, closure will not be allowed. The error message returned will be:
"The account cannot be closed due to a remaining balance."
- If there is no balance, the Locker account will be closed automatically.
-
Automatic Closure:
- Behavior: If the Locker account has no remaining balance and there are no other blocking conditions, closure will occur automatically.
-
Handling Accounts with Balance and Rejection:
- Behavior: If a Locker account has a balance and is rejected during closure, the balance must be cleared by the user, and a new closure request must be generated after the balance is cleared.
-
Unlinking the Locker Account from the Regular Account:
- Behavior: After the Locker account is closed, it will automatically be unlinked from the regular account it was associated with. No additional unlinking request is required.
-
Direct Deletion Without Closure Request:
- Behavior: The closure will be direct, without the creation of a formal request, as long as there is no remaining balance or other blocking conditions. If closure is permitted, the Locker account will be automatically removed.
Updated 9 days ago