Limit management

Method API = 'GetAccountOperationLimit'

This method allows for querying the limits of an account in our transactional products, such as Pix and TED. All Fitbank accounts have limits established for security and regulatory compliance purposes. The bank data fields in the request do not refer to the SPB data of the account, but rather to virtual data.

It is important to provide the bank details of the virtual account in the request (such as Bank, Branch, Bank Account, and Bank Account Digit) to validate the account by the AccountId. Subsequently, the client can use the AccountKey to query the limits, making the other data optional.

If the account does not have virtual account data, the fields should be filled as null, and the system will validate the account based on the provided CPF/CNPJ(TaxNumber).

{
  "Method": "GetAccountOperationLimit",
  "PartnerId": 163,
  "BusinessUnitId": 195,
  "TaxNumber": "12345678912",
  "Bank": 450,
  "BankBranch": "0001",
  "BankAccount": 505615,
  "BankAccountDigit": 3,
  "Type": 0,
  "OperationType": 2,
  "SubType": 0
}

{
  "Success": "true",
  "Message": "Método executado com sucesso.",
  "MinLimit": 0,
  "MaxLimit": 2.000,00
}

Description:

Method API = 'ChangeAccountOperationLimit'

Through this API method, you can adjust the limits of Fitbank's transactional products associated with an account, according to the parameters and limit configurations of the Business Unit.

This method operates similarly to the GetAccountOperationLimit method, ensuring consistency in the account's bank details information.

If the account from which you intend to adjust the limits has virtual account bank details, these details must be included in the query request (fields Bank, Branch, Bank Account, and Bank Account Digit) for the system validation to be conducted by the AccountId (internal account identifier) associated with each account in FitBank.

The eligible products to request limit increases are:

1 - PIX using operation type 40
2 - TED using operation type 3
3 - Card withdrawal using operation type 30

After the request is submitted, a limit increase request is generated and meticulously reviewed by our Risk, Compliance, and Finance teams.

🚧

To enhance the approval likelihood, it's essential to fill in the "Justification" field and, if possible, provide proof of annual revenue for legal entities or monthly income for individuals.

The justifications are as follows:

• 0 - Business: To expand the business and acquire additional equipment.
• 1 - Income: When the current limit does not align with the income/transactions.
• 2 - Emergency: In situations of force majeure.
• 3 - Education: To cover expenses related to education.
• 4 - Health: For unexpected and emergency medical expenses.
• 5 - Travel: To fund a significant trip.
• 6 - Renovation: To cover maintenance/construction costs.

{
  "Method": "ChangeAccountOperationLimit",
  "PartnerId": 30519,
  "BusinessUnitId": 51138,
  "TaxNumber": "84928589076",
  "Bank": "450",
  "BankBranch": "0001",
  "BankAccount": "440246",
  "BankAccountDigit": "3",
  "Type": 0,
  "OperationType": 40,
  "SubType": 1,
  "MaxLimitValue": 0,
  "Justification": 0,
  "Document": {
    "DocumentFile": "dGVzdGU=",
    "DocumentFormat": 0,
    "DocumentName": "Faturamento Anual",
    "DocumentType": 17,
    "Description": "Envio de documento",
    "ExpirationDate": "12/02/2025",
    "DocumentKey": "629F1244DCC245A79DB0C181D3A472CB"
  }
}

👍

Sucess

If your request to the method is successful, the returned message will follow the model below:

Sucess

{
  "status": "approved",            
  "message": "A solicitação foi aprovada e o limite foi ajustado com sucesso." 
}

❗️

Error

If your request to the method is successful, the returned message will follow the model below:

Sucess

{
  "status": "repproved",            
  "message": "A solicitação foi reprovada e o limite atual foi mantido." 
}

📘

To successfully process the request using the ChangeAccountOperationLimit method, the following documents are required:

• Corporate Account: Annual Billing
• Individual Account: Monthly Income

Description:

📘

The limit increase request process can take up to 48 hours to process