Vinculação do cartão com uma conta bancária

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.

Pré-requisitos

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

  • O parceiro tenha emitido pelo menos um lote de cartões;
  • O cliente do parceiro possua uma conta ativa.

Requisição (Request)

Requisição HTTP

POST https://sandbox.hiperbanco.com.br/Cards/no-name-cards/activate
--request POST 'https://sandbox.hiperbanco.com.br/Cards/no-name-cards/activate' \
--header 'version: cutting-edge' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 
--data-raw '{
  "activationCode": "string",
  "onboardingId": "string"
}'

Cabeçalhos (Headers)

NomePropriedadeDescrição
versioncutting-edgeObrigatório. Essa propriedade garante que o response da API seja retornado no formato JSON
AuthorizationBearer tokenObrigató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:

CampoTipoDescrição
activationCodestringCódigo de ativação do cartão.
onboardingIdstringIdentificador do processo de onboarding.
{
  "activationCode": "string",
  "onboardingId": "string"
}

Resposta (Response)

O status code 204 indicará que o cartão foi vinculado à conta com sucesso.

Erros

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

Status CodeCódigoMensagemDescrição
406INVALID_STATUS_FOR_METHODCurrent status does not allow changes by this method!O status atual não pode ser alterado por este método.

Recordamos que esta API também poderá retornar erros comuns entre todos os endpoints que acompanham os erros 400 (se houver).

Eventos

Este endpoint não possui eventos relacionados a ele.