Pular para o conteúdo principal

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_pix/account

Exemplo

{
"account_id": "5ce7fab5-8165-44a5-9b89-bb2d6d61e4f4",
"registration_date": "2019-12-20T15:23:12",
"limit": {
"withdraw": {
"daytime" : {
"start_time": "06:00:00-03:00",
"amount": 500000
},
"nighttime" : {
"start_time": "20:00:00-03:00",
"amount": 300000
}
},
"change": {
"daytime" : {
"start_time": "06:00:00-03:00",
"amount": 500000
},
"nighttime" : {
"start_time": "20:00:00-03:00",
"amount": 300000
}
},
"transaction_natural_person": {
"daytime" : {
"start_time": "06:00:00-03:00",
"amount": 500000
},
"nighttime" : {
"start_time": "20:00:00-03:00",
"amount": 300000
}
},
"transaction_legal_person": {
"daytime" : {
"start_time": "06:00:00-03:00",
"amount": 500000
},
"nighttime" : {
"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.

nometipodescrição
account_idstringIdentificador único da conta.
É essencial que este número seja único para cada requisição
registration_datestring (ISO 8601)Data e hora do cadastro.
limitlimitObjeto do tipo limit.

Objeto Limit

{
"withdraw": {
"daytime" : {
"start_time": "06:00:00-03:00",
"amount": 500000
},
"nighttime" : {
"start_time": "20:00:00-03:00",
"amount": 300000
}
},
"change": {
"daytime" : {
"start_time": "06:00:00-03:00",
"amount": 500000
},
"nighttime" : {
"start_time": "20:00:00-03:00",
"amount": 300000
}
},
"transaction_natural_person": {
"daytime" : {
"start_time": "06:00:00-03:00",
"amount": 500000
},
"nighttime" : {
"start_time": "20:00:00-03:00",
"amount": 300000
}
},
"transaction_legal_person": {
"daytime" : {
"start_time": "06:00:00-03:00",
"amount": 500000
},
"nighttime" : {
"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 quatro categorias principais (ou tipos de limites): "withdraw" (referente a modalidade PIX Saque), "change" (referente a modalidade PIX troco), "transaction_natural_person" (referente a modalidade PIX transacional para pessoas físicas) e "transaction_legal_person" (referente a modalidade PIX transacional para pessoas jurídicas). Cada categoria contem 2 períodos, "daytime" e "nighttime", representando respectivamente os períodos diurno e noturno, descrevendo o horário de início e os respectivos limites de valores a ser aplicados para a modalidade. Vale citar que as 4 categorias de PIX do objeto limit são obrigatórias, devendo estar presentes no momento de criação da conta.

Estrutura de uma Janela de Limite:

nometipodescrição
start_timestring (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.
amountinteiroValor do limite máximo permitido para a modalidade no período especificado pelo "start_time" em centavos de reais.

Exemplo de Uso: Suponhamos que o usuário esteja realizando uma transação PIX para pessoa física no horário 12:00:00-03:00. Ao consultar o objeto, localizamos a categoria "transaction_natural_person". Nessa categoria, encontramos os 2 períodos, "daytime" e "nighttime": o primeiro inicia em "06:00:00-03:00" e o segundo inicia em "20:00:00-03:00". Se a transação 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_pix/account/{account_id}/limit_update_request

Exemplo

{
"withdraw": {
"daytime" : {
"start_time": "06:00:00-03:00",
"amount": 500000
},
"nighttime" : {
"start_time": "20:00:00-03:00",
"amount": 300000
}
},
"change": {
"daytime" : {
"start_time": "06:00:00-03:00",
"amount": 550000
},
"nighttime" : {
"start_time": "20:00:00-03:00",
"amount": 350000
}
},
"transaction_natural_person": {
"daytime" : {
"start_time": "06:00:00-03:00",
"amount": 500000
},
"nighttime" : {
"start_time": "20:00:00-03:00",
"amount": 300000
}
}
}

O retorno da requisição será composto por uma lista com todas as modificações que foram realizadas, separados por período e por categoria de limite PIX. No caso do exemplo acima, as alterações foram realizadas na categoria "change" (PIX Troco) com a requisição para aumento do limite de ambos os periodos. Portanto a resposta da requisição será a seguinte:

{   "limit_update_requests" : [
{
"limit_update_request_id": "5ce7fab5-8165-44a5-9b89-bb2d6d61e4f4",
"analysis_status": "automatically_approved",
"client_notification_status": "not_applicable",
"limit_update_request_status": "applied",
"limit_update_request_type" : "change_daytime",
"event_date": "2019-10-01T10:37:25-03:00"
},
{
"limit_update_request_id": "5ce7fab5-8165-44a5-9b89-bb2d6d61e4f4",
"analysis_status": "automatically_approved",
"client_notification_status": "not_applicable",
"limit_update_request_status": "applied",
"limit_update_request_type" : "change_nighttime",
"event_date": "2019-10-01T10:37:25-03:00"
},
]
}
nometipodescrição
limit_update_request_idstringIdentificador único da Proposta de Modificação de Limite
analysis_statusstringEnumerador do analysis_status da proposta
client_notification_statusstringEnumerador do client_notification_status da proposta
limit_update_request_statusstringEnumerador do limit_update_request_status da proposta
limit_update_request_typestringEnumerador do limit_update_request_type da proposta
event_datestring (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 .