5 - Limit management

Configuration and management of PIX limits

In a security agenda, central bank “Banco Central” established limits of transactions to be configured based on defined nocturnal and diurnal hours periods.

With these requests, the client application can allow managing, configuring and updating PIX limits.

PIX limits

Get Account Operation Limit

API Method = GetAccountOperationLimit

Through this method, it is possible to consult PIX limit information regarding current configuration of an account.

In FitBank this method is not unique to PIX, as it applies to other Fit transactions that use virtual account data. Thus, in the request for this method, the bank data fields do not refer to the SPB data of the account used to operate with PIX.

Important: If the account from which the user wants to consult the limits has virtual account bank details, it must be informed in the query request (fields Bank, BankBranch, BankAccount and BankAccountDigit), so that the system validation is made by the AccountId (account's internal identifier) that each account has in FitBank.

If the account in question does not have this virtual account data, the fields Bank, BankBranch, BankAccount and BankAccountDigit must be filled as null. In this case, the system will validate the account based on the informed 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
}

Description:

ParameterDescriptionMandatoryTypeComments
MethodMethod to be usedYESSTRING-
PartnerIdInformation provided by FitBankYESINT-
BusinessUnitIdInformation provided by FitBankYESINT-
TaxNumberCPF/CNPJ of the owner of the accountYESSTRING-
BankBank Code (Ex.: “450”).YESSTRING-
BankBranchBank Agency Code (Ex.: “0001”)YESSTRING-
BankAccountBank Account (Ex.: “146492”)YESSTRING-
BankAccountDigitBank Account Digit (Ex.: “1”)YESSTRING-
TypeParameter indicating type of limit being requestedYESINTDaily = 0
Overnight = 3
SingleTransaction = 4
OperationTypeParameter indicating type of operation which limit being requestedYESINTBy default, fill this field as 40, referring to the PixOut operation
SubTypeParameter indicating subtype of limit being requestedYESINTQuantity = 0 (number/quantity of transactions that the account can perform)

Amount = 1 (value/amount of the transactions that the account can perform)

Change Account Operation Limit

API Method = ChangeAccountOperationLimit

PIX limit modification based on current values. Through this API method, it is possible to configure (reduce or enlarge) PIX limits of an account according to the parameters and limit configurations of the business unit.

This method follows the same logic as the GetAccountOperationLimit method, regarding information of bank details of an account.

If the account from which the user wants to change the limits has virtual account bank details, it must be informed in the query request (fields Bank, BankBranch, BankAccount and BankAccountDigit), so that the system validation is made by the AccountId (account's internal identifier) that each account has in FitBank.

If the account in question does not have this virtual account data, the fields Bank, BankBranch, BankAccount and BankAccountDigit must be filled as null. In this case, the system will validate the account based on the informed CPF/CNPJ (TaxNumber).

In PIX, by default, you can only change the payment limits (PixOut), because PIX receipts are released and have no limit.

{
  "Method": "ChangeAccountOperationLimit",
  "PartnerId": 123,
  "BusinessUnitId": 114,
  "TaxNumber": "12345678912",
  "Bank": "123",
  "BankBranch": "1341",
  "BankAccount": "111111",
  "BankAccountDigit": "1",
  "Type": 0,
  "OperationType": 40,
  "SubType": 1,
  "MinLimitValue": 0,
  "MaxLimitValue": 10000000
}

Description:

ParameterDescriptionMandatoryTypeComments
MethodMethod to be usedYESSTRING-
PartnerIdInformation provided by FitBankYESINT-
BusinessUnitIdInformation provided by FitBankYESINT-
TaxNumberCPF/CNPJ of who has the PIX keyYESSTRING-
BankBank Code (Ex.: “450”)YESSTRING-
BankBranchBank Agency Code (Ex.: “0001”)YESSTRING-
BankAccountBank Account (Ex.: “146492”)YESSTRING-
BankAccountDigitBank Account Digit (Ex.: “1”)YESSTRING-
TypeParameter indicating type of limit being requestedYESINTDaily = 0
Overnight = 3
SingleTransaction = 4
OperationTypeParameter indicating type of operation which limit being requestedYESINTBy default, fill this field as 40, referring to the PixOut operation
SubTypeParameter indicating subtype of limit being requestedYESINTQuantity = 0 (number/quantity of transactions that the account can perform)

Amount = 1 (value/amount of the transactions that the account can perform)
MinLimitValueMinimum value to initiate a PixOut transaction based on type conditionsYESNUMBER-
MaxLimitValueMaximum value to initiate a PixOut transaction based on type conditionsYESNUMBER-