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ção | Descrição |
|---|---|
| Limites globais do tenant | Definem os tetos operacionais consolidados e os valores máximos permitidos para as transações. |
| Limites padrão por conta | Definem 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 / modalidade | limitType | name | description | category | period |
|---|---|---|---|---|---|
| Pix — Pessoa Jurídica | PixPJ | Pix - Pessoa Jurídica | Limite diário para transações Pix de pessoas jurídicas | PIX | DAILY — Diário (00h às 23h59) |
| Pix — Pessoa Física | PixPF | Pix - Pessoa Física | Limite para transações Pix de pessoas físicas com janelas diurna e noturna | PIX | DIURNAL — Diurno (06h às 20h) ou NOCTURNAL — Noturno (20h às 6h) |
| Pix — Pessoa Física para Pessoa Jurídica | PixPFPJ | Pix - Pessoa Física para Pessoa Jurídica | Limite diário para transações Pix entre pessoas físicas e jurídicas | PIX | DAILY — Diário (00h às 23h59) |
| Pagamento de boletos | Billpayments | Pagamento de Boletos | Limite diário para pagamento de boletos | PAYMENTS | DAILY — Diário (00h às 23h59) |
| TED — Pessoa Jurídica | TedPJ | TED - Pessoa Jurídica | Limite diário para transferências TED de pessoas jurídicas | TED | DAILY — Diário (00h às 23h59) |
| TED — Pessoa Física | TedPF | TED - Pessoa Física | Limite diário para transferências TED de pessoas físicas | TED | DAILY — Diário (00h às 23h59) |
| Favorecidos | Favorites | Favorecidos | Limite diário para transferências a favorecidos cadastrados | TRANSFER | DAILY — Diário (00h às 23h59) |
| TEF | em construção | ||||
Estrutura do período
O objeto period identifica a janela de aplicação do limite:
| Campo | Descrição |
|---|---|
type | Tipo de período, como DAILY ou DIURNAL. |
label | Descrição legível da janela de aplicação. |
startTime | Horário inicial do período. |
endTime | Horá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.
Updated about 2 hours ago