Solicitar alteração de limite Pix

Request

ENDPOINT

/baas/pix/limits/ACCOUNT_KEY

MÉTODO

POST

Request Body

{
    "daily_amount_limit": 2000.00,
    "nightly_amount_limit": 1000.00,
    "self_daily_amount_limit": 1500.00,
    "self_nightly_amount_limit": 500.00
}

Body Params

Campo	Tipo	Descrição
daily_amount_limit	float	Limite durante o período diurno para transferências Pix de diferente titularidade
nightly_amount_limit	float	Limite durante o período noturno para transferências Pix de diferente titularidade
self_daily_amount_limit	float	Limite durante o período diurno para transferências Pix de mesma titularidade
self_nightly_amount_limit	float	Limite durante o período noturno para transferências Pix de mesma titularidade

Horário diurno

Para o período diurno são contabilizadas transferências realizadas entre 06:00 e 20:00.

Atenção

As Solicitações de aumento de limite Pix possuem um SLA de 48 horas para aprovação.

Solicitações de redução do limite Pix são aprovação e executadas imediatamente.

Response

STATUS

200

Response Body

[
	{
		"account_digit": "5",
		"account_key": "467ce632-cc2c-412a-bc56-aa949bd8393d",
		"account_name": "Default",
		"account_number": "26709",
		"amount_limit": 2000.0,
		"event_type": "pix_limit_request",
		"limit_type": "daily",
		"owner_document_number": "63602991000100",
		"request_status": "pending_approval",
		"requester_document_number": "77669728833"
	},
	{
		"account_digit": "5",
		"account_key": "467ce632-cc2c-412a-bc56-aa949bd8393d",
		"account_name": "Default",
		"account_number": "26709",
		"amount_limit": 1000.0,
		"event_type": "pix_limit_request",
		"limit_type": "nightly",
		"owner_document_number": "63602991000100",
		"request_status": "pending_approval",
		"requester_document_number": "77669728833"
	},
	{
		"account_digit": "5",
		"account_key": "467ce632-cc2c-412a-bc56-aa949bd8393d",
		"account_name": "Default",
		"account_number": "26709",
		"amount_limit": 1500.0,
		"event_type": "pix_limit_request",
		"limit_type": "self_daily",
		"owner_document_number": "63602991000100",
		"request_status": "pending_approval",
		"requester_document_number": "53417895200"
	},
	{
		"account_digit": "5",
		"account_key": "467ce632-cc2c-412a-bc56-aa949bd8393d",
		"account_name": "Default",
		"account_number": "26709",
		"amount_limit": 500.0,
		"event_type": "pix_limit_request",
		"limit_type": "self_nightly",
		"owner_document_number": "63602991000100",
		"request_status": "pending_approval",
		"requester_document_number": "53417895200"
	}
]

STATUS

400

Response Body: Número enviado inválido

{
	"title": "Bad Request",
	"description": "Invalid decimal amount, sent 1500.001",
	"translation": "Valor decimal inválido, enviado 1500.001",
	"code": "PXT000043",
	"additional_data": {}
}

STATUS

403

Response Body: Usuário não possui credenciais

{
    "title": "Unauthorized",
    "description": "User is not allowed to do this transaction",
    "translation": "Usuário não tem autorização para fazer essa transação",
    "code": "PIT000001"
}

Webhook Response

Evento gerador de webhook

Webhooks são enviados ao requisitante da conta ao ser realizada a execução da solicitação de limite

Webhook Request Accepted Body

{
   "webhook_type": "baas.pix.limits.account_limit_config.updated",
   "webhook_datetime": "2023-08-05T19:54:01.514Z",
   "data": {
      "pix_transfer_limit_config": [
         {
            "period": "daily",
            "account_key": "467ce632-cc2c-412a-bc56-aa949bd8393d",
            "amount_limit": 800012.67,
            "self_amount_limit": 500.03
         },
         {
            "period": "nightly",
            "account_key": "467ce632-cc2c-412a-bc56-aa949bd8393d",
            "amount_limit": 100000.0,
            "self_amount_limit": 100000.0
         }
      ]
   }
}

Webhook Request Rejected Body

{
   "webhook_type":"baas.pix.limits.account_limit_config.updated",
   "webhook_datetime": "2023-08-05T19:54:01.514Z",
   "data":{
     "message": "QI Tech informa que a solicitacao de limite PIX diário para terceiros da sua conta foi rejeitada. Motivo: limite reanalisado.",
     "account_key": "467ce632-cc2c-412a-bc56-aa949bd8393d",
     "request_status": "rejected",
     "limit_type": "daily"
   }
}

Enumeradores limit_type

Enumerador	Descrição
daily	Limite durante o período diurno para transferências Pix de diferente titularidade
nightly	Limite durante o período noturno para transferências Pix de diferente titularidade
self_daily	Limite durante o período diurno para transferências Pix de mesma titularidade
self_nightly	Limite durante o período noturno para transferências Pix de mesma titularidade