Vinculação do cartão com uma conta bancária
stablescopes: card.update
O cartão No Name somente é ativado quando vinculado a uma conta.
Após a criação desse vínculo, o seu cliente já poderá definir uma senha para o uso do cartão.
Etapas
Endpoint
Para utilizar este endpoint, preencha os seguintes campos obrigatórios:
Path:
activateCode
: código de ativação do cartão (12 caracteres).
Body:
password
: senha para uso do cartão (deve possuir quatro dígitos);bankAgency
: número da agência (quatro dígitos);bankAccount
: número da conta ao qual o cartão será vinculado;documentNumber
: número de documento (CPF ou CNPJ). Informe somente números. O tamanho máximo desse campo é de 14 caracteres.
Opcionalmente, informe:
alias
: apelido do cartão que poderá auxiliar o cliente a identificá-lo no aplicativo. O alias não será impresso no cartão. Para preencher esse campo, não é permitido o uso de caracteres especiais e seu tamanho máximo é de 16 caracteres.
curl --location --request PATCH
--url 'https://api-mtls.sandbox.bankly.com.br/cards/activateCode/{{activateCode}}/binding' \
--header 'api-version: 1' \
--header 'Authorization: Bearer {{accessToken}}' \
--header 'Content-Type: application/json' \
--data-raw '
{
"password": "1234",
"bankAgency": "4321",
"bankAccount": "123456",
"documentNumber": "12345678900"
}
Retorno
O status code 200 indicará que o cartão foi vinculado à conta com sucesso.
Erros
Status code | Código | Descrição |
---|---|---|
400 | NVALID_PARAMETER | Conteúdo da requisição não está de acordo com o esperado. Exemplos: tamanho de campo, tipo ou conteúdo obrigatório. |
401 | UNAUTHORIZED | Sem autorização para realizar a solicitação. |
404 | Card not found | Cartão não encontrado. |
406 | 018 | O status atual não pode ser alterado por este método. |
500 | 014 | Ocorrência de erro inesperado. |
Updated 12 months ago