Alteração de limite ativo de cartão pós-pago

stable pós

Este endpoint possibilita que o cliente do parceiro Bankly altere o limite de crédito ativo do seu cartão pós-pago.

📘

Nota

Limite de crédito ativo é aquele determinado pelo cliente dentro da faixa de limite pré-estabelecida pelo parceiro após a análise de crédito.

Pré-requisito

Para que seja possível utilizar este endpoint, é necessário que:

Requisição

Requisição HTTP

PATCH 'https://api-mtls.sandbox.bankly.com.br/cards/limit'
--request PATCH \
--url https://api-mtls.sandbox.bankly.com.br/cards/limit \
--header 'accept: application/json' \
--header 'api-version: 1' \
--header 'content-type: application/json' \
--header 'Authorization: Bearer {token}' \
--data-raw '
  {
    "documentNumber": "47742663023",
    "contractNumber": "000124",
    "limit": 200
  }'

Autorização

Para garantir a segurança nas requisições, todos os endpoints do Bankly utilizam scopes como parte do seu fluxo de autorização.

Esta requisição requer o scope descrito a seguir:

ScopeDescrição
card.updateConcede acesso para atualizar o limite de crédito de uma cartão.

Cabeçalhos (Headers)

NomeDescrição
api-versionObrigatório. Versão da API. Atualmente estamos na versão 1.0.
AuthorizationObrigatório. Token de autorização do tipo Bearer.

Parâmetros da rota (Path)

Não é necessário enviar parâmetros no path desta requisição.

Corpo da requisição (Body)

No body, envie os seguintes campos em formato JSON:

NomeTipoDescriçãoEspecificação
documentNumberstringObrigatório. Número de documento de CPF ou CNPJ.Informe somente os números. Exemplo: “00000000000”.
contractNumberstringObrigatório. Número do contrato do cliente.
limitnumberObrigatório. Novo limite de crédito ativo (definido pelo cliente).
{
	"documentNumber": "47742663023",              
	"contractNumber": "467343786316847",  
	"limit": 750.50   
}

Resposta (Response)

O status code 204 indicará que a solicitação foi aceita com sucesso e que o limite foi alterado.

👍

Dica

Para simular uma requisição nesse endpoint, acesse o API Reference.

Erros

Este endpoint pode retornar um erro específico, conforme a tabela a seguir:

Status codeCódigoMensagemDescrição
400LIMIT_REQUESTED_INVALIDLimit requested is invalid!Limite solicitado maior que o disponível.

Recordamos que esta API também poderá retornar erros comuns entre todos os endpoints. Portanto, recomendamos a consulta da documentação de erros, onde é possível encontrar as mensagens comuns em inglês que acompanham os erros 400 (se houver).

Eventos

Este endpoint não possui eventos relacionados a ele.