Cadastro de Novo Limite

Para realizar o cadastro de um novo limite, basta enviar um objeto do tipo Account ao seguinte endpoint:

POST https://api.caas.qitech.app/limits/account

Exemplo

{
    "account_id": "5ce7fab5-8165-44a5-9b89-bb2d6d61e4f4",
    "registration_date": "2019-12-20T15:23:12",
    "limit": {
        "pix": {
            "withdraw": [
                {
                    "start_time": "06:00:00-03:00",
                    "amount": 500000
                },
                {
                    "start_time": "20:00:00-03:00",
                    "amount": 300000
                }
            ],
            "change": [
                {
                    "start_time": "06:00:00-03:00",
                    "amount": 500000
                },
                {
                    "start_time": "20:00:00-03:00",
                    "amount": 300000
                }
            ],
            "transaction_natural_person": [
                {
                    "start_time": "06:00:00-03:00",
                    "amount": 500000
                },
                {
                    "start_time": "20:00:00-03:00",
                    "amount": 300000
                }
            ],
            "transaction_legal_person": [
                {
                    "start_time": "06:00:00-03:00",
                    "amount": 500000
                },
                {
                    "start_time": "20:00:00-03:00",
                    "amount": 300000
                }
            ]
        }
    }
}

Todas as trocas de informação de um cadastro utilizam a seguinte definição para este objeto. Em alguns casos, para facilitar a implementação e diminuir o fluxo de dados entre as partes, algumas informações poderão ser omitidas.

nome	tipo	descrição
account_id	string	Identificador único da conta. É essencial que este número seja único para cada requisição
registration_date	string (ISO 8601)	Data e hora do cadastro.
limit	limit	Objeto do tipo limit.

Objeto Limit

{
    "pix": {
        "withdraw": [
            {
                "start_time": "06:00:00-03:00",
                "amount": 500000
            },
            {
                "start_time": "20:00:00-03:00",
                "amount": 300000
            }
        ],
        "change": [
            {
                "start_time": "06:00:00-03:00",
                "amount": 500000
            },
            {
                "start_time": "20:00:00-03:00",
                "amount": 300000
            }
        ],
        "transaction": [
            {
                "start_time": "06:00:00-03:00",
                "amount": 500000
            },
            {
                "start_time": "20:00:00-03:00",
                "amount": 300000
            }
        ]
    }
}

Este objeto representa os limites de valores aplicáveis aos diferentes tipos de transações em diferentes momentos do dia, levando em consideração a divisão de períodos diurno e noturno.

O objeto está organizado em três categorias principais (ou tipos de limites): "withdraw" (referente a modalidade PIX Saque), "change" (referente a modalidade PIX troco) e "transaction" (referente a modalidade PIX transacional). Cada categoria pode conter uma lista de até dois dicionários, cada um representando - respectivamente - o período diurno e noturno de limite, descrevendo o horário de início e os respectivos limites de valores a ser aplicados para a modalidade.

Estrutura de uma Janela de Limite:

nome	tipo	descrição
start_time	string (ISO 8601)	Indica o momento em que os limites de valor para transações PIX são aplicados. Atente-se para a configuração correta do início da Janela de Limite de acordo com o fuso horário que pretende utilizar.
amount	inteiro	Valor do limite máximo permitido para a modalidade no período especificado pelo "start_time" em centavos de reais.

Uma vez que, de acordo com as diretrizes do Banco Central, as janelas diurnas de limites PIX devem iniciar obrigatoriamente as 6AM, apenas o valor "06:00:00-03:00" será atualmente aceito para configuração do start_time destas janelas.

De maneira similar como as janelas noturnas de limites PIX devem iniciar às 8PM ou às 10PM apenas os valores "20:00:00-03:00" e "22:00:00-03:00", respectivamente, serão aceitos para configuração do start_time destas janelas.

Exemplo de Uso: Suponhamos que o usuário esteja realizando uma transação PIX no horário 12:00:00-03:00. Ao consultar o objeto, localizamos a categoria "transaction" (Transação PIX). Nessa categoria, encontramos dois dicionários: o primeiro inicia em "06:00:00-03:00" e o segundo inicia em "20:00:00-03:00". Se a transação PIX for realizada entre esses horários, o limite máximo de valor permitido é de 5.000,00 (cinco mil) reais, conforme especificado na primeira janela de limite.

No entanto, caso a transação ocorra após "20:00:00-03:00" e antes do próximo horário de início (neste exemplo, às 06:00 do dia seguinte), o limite máximo de valor permitido será de 3.000,00 (três mil) reais, conforme indicado na segunda janela (janela noturna) de limite.

Criando uma Proposta de Modificação de Limite

Para solicitar uma modificação de um limite, basta enviar um objeto do tipo Limit ao seguinte endpoint:

POST https://api.caas.qitech.app/limits/account/{account_id}/limit_update_request

Exemplo

{
    "pix": {
        "withdraw": [
            {
                "start_time": "06:00:00-03:00",
                "amount": 500000
            },
            {
                "start_time": "20:00:00-03:00",
                "amount": 300000
            }
        ],
        "change": [
            {
                "start_time": "06:00:00-03:00",
                "amount": 500000
            },
            {
                "start_time": "20:00:00-03:00",
                "amount": 300000
            }
        ],
        "transaction_natural_person": [
            {
                "start_time": "06:00:00-03:00",
                "amount": 500000
            },
            {
                "start_time": "20:00:00-03:00",
                "amount": 300000
            }
        ]
    }
}

Que apresentará o seguinte retorno:

{
    "limit_update_request_id": "5ce7fab5-8165-44a5-9b89-bb2d6d61e4f4",
    "analysis_status": "automatically_approved",
    "client_notification_status": "not_applicable",
    "limit_update_request_status": "applied",
    "event_date": "2019-10-01T10:37:25-03:00"
}

nome	tipo	descrição
limit_update_request_id	string	Identificador único da Proposta de Modificação de Limite
analysis_status	string	Enumerador do analysis_status da proposta
client_notification_status	string	Enumerador do client_notification_status da proposta
limit_update_request_status	string	Enumerador do limit_update_request_status da proposta
event_date	string (ISO 8601)	Data e hora da criação da Proposta de Modificação de Limite

Para um melhor entendimento dos status de retorno acesse dinâmica de status .