Vinculação do cartão combo a uma conta

Este endpoint possibilita vincular um cartão do tipo combo a uma conta bancária. Desse modo, a modalidade de débito do cartão será ativada.

🚧

Importante

A vinculação de um cartão a uma conta bancária só é realizada uma vez e não pode ser desfeita.

Pré-requisitos

Para que seja possível utilizar este endpoint, é necessário que o cliente do parceiro Bankly:

• Possua uma conta ativa;
• Tenha criado um cartão do tipo combo somente com o crédito habilitado (sem informar agência e conta no momento da emissão), e que nunca tenha sido vinculado a uma conta bancária.

Requisição (Request)

PATCH 'https://api-mtls.sandbox.bankly.com.br/cards/{proxy}/account'

--request PATCH 
--url 'https://api-mtls.sandbox.bankly.com.br/cards/{proxy}/account' \
--header 'api-version: 1' \ 
--header 'Authorization: Bearer {{Token}}' \ 
--header 'Content-Type: application/json' \ 
--data-raw '{ 
     "account": {
          "branch": "0001", 
          "number": "62150075442" 
     }
}'

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 o seguinte campo:

Corpo da requisição (Body)

No body, envie os seguintes campos em formato JSON:

{
   "account": {
     "branch": "0001", 
     "number": "62150075442" 
	}
}

Resposta (Response)

O status code 202 indicará que a solicitação foi aceita e que o cartão está sendo vinculado à conta.

👍

Dica

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

Erros

Este endpoint pode retornar erros específicos, conforme a tabela a seguir:

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

Caso o parceiro deseje receber mensagens referentes aos eventos relacionados a esse endpoint, é preciso configurar o webhook. Os eventos são: