Cancela Solicitação de Alteração de Limite
Permite cancelar uma solicitação de alteração de limite que ainda não foi efetivada, com status SCHEDULED ou PENDING. Este recurso oferece autonomia para desfazer uma solicitação realizada por engano por exemplo, sem precisar aguardar sua efetivação.
Endpoint: DELETE /accounts/{account}/limits
Passos para Integrar
- Realizar autenticação na API - [API Reference]
- Realizar o cancelamento de uma solicitação de alteração de limite - [API Reference]
Parâmetros da requisição
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| account | string | Identificador da conta à qual a solicitação de alteração de limite está vinculada. | Sim |
| clientRequestId | String | Identificador da solicitação definido pelo cliente. | Condicional |
| limitId | String | Sim, se clientRequestId não for informado | Condicional |
Regras gerais
- O cancelamento é permitido somente para solicitações com status
SCHEDULEDouPENDING, ainda não efetivadas. - O parâmetro
accounté obrigatório e faz parte dos critérios de identificação da solicitação elegível ao cancelamento. - É obrigatório informar
clientRequestIdoulimitId. - Quando os dois identificadores forem informados, o
limitIdprevalece. - A resposta de sucesso da API retorna sempre o status
PROCESSING, indicando que a solicitação de cancelamento está em processamento.
cURL da chamada - Caso o cliente opte por identificar a solicitação pelo limitId.
curl --request DELETE \
--url 'https://sandbox.openfinance.celcoin.dev/baas/v2/accounts/30023646094074/limits?limitId=LMR-20260804-98765' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Accept: application/json'URL da chamada - Caso o cliente opte por identificar a solicitação pelo clientRequestId
curl --request DELETE \
--url 'https://sandbox.openfinance.celcoin.dev/baas/v2/accounts/30023646094074/limits?clientRequestId=REQ-12345' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Accept: application/json'Exemplo de retorno
{
"status": "PROCESSING",
"version": "1.0.0",
"body": {
"limitId": "LMR-20260804-98765",
"account": "30023646094074",
"limitType": "PixPJ",
"clientRequestId": "REQ-12345",
"name": "Pix - Pessoa Jurídica",
"period": { "type": "DAILY", "label": "Diário" },
"operationType": "DECREASE",
"previousValue": 1000.0,
"requestedValue": 3000.0,
"requestedAt": "2026-08-04T15:30:00Z",
"updateAt": "2026-08-05T15:30:00Z"
}
}{
"status": "ERROR",
"version": "1.0.0",
"error": {
"errorCode": "CBE523",
"message": "<limitType` não informado>"
}
}Tabela de errorCode
| Code | Message |
|---|---|
CBE091 | É necessário informar o campo: account. |
CBE531 | Necessário informar clientRequestId ou Id |
CBE239 | Não foi possivel recuperar os dados do cliente para busca do JWT. |
CBE690 | Não foram encontrados limites cadastrados para a conta informada. |
CIE999 | Ocorreu um erro interno durante a chamada da api. |
Updated about 2 hours ago
Did this page help you?