Envio de dados para conclusão de alteração de limite

Quando uma reanálise de crédito é finalizada, são disparados eventos relativos às jornadas específicas de coleta de evidências junto ao portador do cartão de crédito (cliente do parceiro). Tais eventos são:

• CREDIT_CONTRACT_LIMIT_INCREASE_ON_HOLD, em caso de aumento do valor de limite do contrato de crédito, para coletar o aceite do portador;
• CREDIT_CONTRACT_LIMIT_REDUCTION_ON_HOLD, em caso de redução do valor de limite do contrato de crédito, para coletar evidência da notificação entregue ao portador.

Assim que as evidências forem coletadas, elas devem ser enviadas ao Bankly por meio do endpoint descrito a seguir, destinado à recepção dos dados para que o fluxo de alteração de limite seja finalizado.

Pré-requisitos

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

• O pedido de reanálise de crédito tenha sido aprovado.

Requisição (Request)

Requisição HTTP

POST https://api-mtls.sandbox.bankly.com.br/cards/credits/document/{documentNumber}/contract/{contractId}/solicitation/{solicitationId}/limitCommunication \

--request PATCH \
--url 'https://api-mtls.sandbox.bankly.com.br/cards/credits/document/{documentNumber}/contract/{contractId}/solicitation/{solicitationId}/limitCommunication' \
--header 'Authorization: Bearer' \
--header 'accept: application/json' \
--header 'api-version: 1' \
--header 'content-type: application/json' \
--data '
{
	"communication": {
		"datahash": "string",
		"communicatedAt": "",
		"type":  "limitIncreaceAccepted | limitIncreaseReproved| limitReductionNotNotified| limitReductionNotified"
	}
}
'

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:

Cabeçalhos (Headers)

Parâmetros da rota (Path)

No path desta requisição envie os seguintes campos:

Corpo da requisição (Body)

No body, envie os seguintes campos em formato JSON:

{
	"communication": {
		"datahash": "string",
		"communicatedAt": "2025-04-29T21:41:51.978Z",
		"type":  "limitIncreaceAccepted"
	}
}

Resposta (Response)

O status code 202 indicará que o aceite da nova proposta do contrato de crédito foi enviado com sucesso.

👍

Dica

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

Erros

Este endpoint não retorna erros específicos. Porém, ele poderá retornar alguns erros comuns entre todos os endpoints.

Eventos

Assim que os dados forem recebidos na Bankly os eventos abaixo serão emitidos e caso o parceiro deseje receber mensagens é preciso configurar o webhook.

Os eventos são: