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 codeCódigoDescrição
400NVALID_PARAMETERConteúdo da requisição não está de acordo com o esperado. Exemplos: tamanho de campo, tipo ou conteúdo obrigatório.
401UNAUTHORIZEDSem autorização para realizar a solicitação.
404Card not foundCartão não encontrado.
406018O status atual não pode ser alterado por este método.
500014Ocorrência de erro inesperado.