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

  1. Realizar autenticação na API - [API Reference]
  2. Realizar o cancelamento de uma solicitação de alteração de limite - [API Reference]

Parâmetros da requisição

CampoTipoDescriçãoObrigatório
accountstringIdentificador da conta à qual a solicitação de alteração de limite está vinculada.Sim
clientRequestIdStringIdentificador da solicitação definido pelo cliente.Condicional
limitIdStringSim, se clientRequestId não for informadoCondicional

Regras gerais

  • O cancelamento é permitido somente para solicitações com status SCHEDULED ou PENDING, 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 clientRequestId ou limitId.
  • Quando os dois identificadores forem informados, o limitId prevalece.
  • 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

👍

Sucesso 200 - sucesso agendado (dentro do teto e maior que o atual):

{
  "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"
  }
}
❗

Error 400

{
  "status": "ERROR",
  "version": "1.0.0",
  "error": {
    "errorCode": "CBE523",
    "message": "<limitType` não informado>"
  }
}

Tabela de errorCode

CodeMessage
CBE091É necessário informar o campo: account.
CBE531Necessário informar clientRequestId ou Id
CBE239Não foi possivel recuperar os dados do cliente para busca do JWT.
CBE690Não foram encontrados limites cadastrados para a conta informada.
CIE999Ocorreu um erro interno durante a chamada da api.

Did this page help you?