Criação e Atribuição de Limites por Conta

A atribuição de limites transacionais por conta não possui um endpoint disponibilizado para consumo pelos clientes. A configuração é realizada durante o processo de Onboarding do cliente, e os limites padrão são atribuídos automaticamente às contas conforme os parâmetros definidos.

A configuração considera os limites globais do tenant e os limites padrão por conta, que determina a criação dos baldes e a validação de limites transacionais habilitados.

Configuração de limites do tenant

Durante o Onboarding, são definidos os seguintes parâmetros:

ConfiguraçãoDescrição
Limites globais do tenantDefinem os tetos operacionais consolidados e os valores máximos permitidos para as transações.
Limites padrão por contaDefinem os limites atribuídos automaticamente às contas durante sua criação.

Criação de limites para novas contas

  • Quando uma conta é aberta, o fluxo segue estas etapas:
    • O fluxo de Onboarding no momento da criação de uma nova conta verifica as configurações de limites;
    • Se os limites estiverem configurados / cadastrados, são acionados os fluxos de criação dos baldes definidos no Bucket Template do tenant.
    • Os limites configurados passam a compor as regras de controle transacional da conta.
    • Agora, se os limites não estiverem parametrizados, quer dizer que o fluxo de validação está desabilitado. Sendo assim, os baldes não são criados e as transações da conta não passam pela validação de limites transacionais.

Tipos de limites por produto

Os tipos de limite são identificados pelo campo limitType e possuem metadados que descrevem sua finalidade, categoria e período de aplicação.

Produto / modalidadelimitTypenamedescriptioncategoryperiod
Pix — Pessoa JurídicaPixPJPix - Pessoa JurídicaLimite diário para transações Pix de pessoas jurídicasPIXDAILY — Diário (00h às 23h59)
Pix — Pessoa FísicaPixPFPix - Pessoa FísicaLimite para transações Pix de pessoas físicas com janelas diurna e noturnaPIXDIURNAL — Diurno (06h às 20h) ou NOCTURNAL — Noturno (20h às 6h)
Pix — Pessoa Física para Pessoa JurídicaPixPFPJPix - Pessoa Física para Pessoa JurídicaLimite diário para transações Pix entre pessoas físicas e jurídicasPIXDAILY — Diário (00h às 23h59)
Pagamento de boletosBillpaymentsPagamento de BoletosLimite diário para pagamento de boletosPAYMENTSDAILY — Diário (00h às 23h59)
TED — Pessoa JurídicaTedPJTED - Pessoa JurídicaLimite diário para transferências TED de pessoas jurídicasTEDDAILY — Diário (00h às 23h59)
TED — Pessoa FísicaTedPFTED - Pessoa FísicaLimite diário para transferências TED de pessoas físicasTEDDAILY — Diário (00h às 23h59)
FavorecidosFavoritesFavorecidosLimite diário para transferências a favorecidos cadastradosTRANSFERDAILY — Diário (00h às 23h59)
TEFem construção

Estrutura do período

O objeto period identifica a janela de aplicação do limite:

CampoDescrição
typeTipo de período, como DAILY ou DIURNAL.
labelDescrição legível da janela de aplicação.
startTimeHorário inicial do período.
endTimeHorário final do período.

Exemplo de configuração para limite diário:

{
  "limitType": "PixPJ",
  "name": "Pix - Pessoa Jurídica",
  "description": "Limite diário para transações Pix de pessoas jurídicas",
  "category": "PIX",
  "period": {
    "type": "DAILY",
    "label": "Diário (00h às 23h59)",
    "startTime": "00:00",
    "endTime": "23:59"
  }
}

Hierarquia e restrições

  • Os limites atribuídos individualmente às contas devem respeitar os tetos definidos na hierarquia do tenant.
  • Os limites padrão são definidos na configuração do cliente/tenant e atribuídos durante a abertura da conta, quando a validação estiver habilitada.
  • Os limites individuais não podem ultrapassar os tetos aplicáveis definidos para o tenant.
  • A criação dos baldes depende das configurações realizadas;

Lembre-se:

  • Não existe endpoint público para atribuição inicial dos limites por conta; essa configuração ocorre por meio dos processos internos de Onboarding e de sincronização de contas (novas e legadas.)
  • A configuração dos Limites pode contemplar diferentes tipos de limite, conforme os produtos contratados e as regras aplicáveis, incluindo limites por período, modalidade de transferência e favorecidos.

Consulta dos limites atribuídos:

Para consultar os limites existentes em uma conta, você pode utilizar o endpoint: GET /accounts/{account}/limits.

A consulta permite visualizar os limites atribuídos à conta e seus respectivos dados, conforme os filtros e o contrato definidos na documentação de Consulta de Limites da Conta.


Did this page help you?