Alteração de status

Altere o status atual de um cartão, realizando bloqueio ou desativando o cartão definitivamente.


Passos para Integrar

  1. Realizar autenticação na API
  2. Ter um cartão emitido na Celcoin
  3. Realizar a alteração de status desejada



Alteração de status

Para realizar a alteração de status de um cartão, após a autenticação, é necessário enviar a seguinte requisição:

cURL da chamada

curl -X 'PUT' \
  'https://kubernetes.celcoin.dev/api/card/{cardId}/status?cardId=1' \
  -H 'accept: application/json'

👍

Sucesso 200

{
  "version": 1,
  "status": 200,
  "body": {
    "id": 1,
    "statusId": 1,
    "status": "NORMAL"
  }
}

Significado dos objetos

CampoTipoDescrição
idintId do cartão gerado na emissão
statusidintStatus em que o cartão se encontra
statusstring(10)Descrição do status que o cartão se encontra

Os possíveis status que podem ser atrelados a um cartão, são os seguintes:

StatusId do StatusDescrição
CREATED1Criado no sistema.
UNBOUND2Cartão Noname ainda não atribuído ao cliente.
NORMAL3Ativo e elegível para transações. Padrão para cartões virtuais.
REISSUED4O cartão foi reemitido
BLOCKED5Temporariamente bloqueado até que novos status sejam alterados.

Um cartão pode ser bloqueado, por exemplo, se o titular do cartão tiver excedido suas tentativas permitidas de inserir uma senha.
PENDING6Criado e pendente até processamento posterior, como verificação de conta. Até lá, as transações estão desativadas.
WARNING7Um sinalizador de alerta geral é definido e as transações são desabilitadas. Após investigação, poderia, normalmente, transitar para ou voltar a FRAUD ou NORMAL
LOST8Perda relatada
ROBBED9Denúncia de roubo
EXPIRED10Expiração da data do cartão atingida
DAMAGED11Avariado
FRAUD12Suspeita de fraude
CANCELED13Cancelado
DELETED14Deletado
BROKEN15Não é mais fisicamente utilizável
THEFT16Roubado
DEFECT17Tem defeito

🚧

Atenção!

Quando um cartão passar para um dos seguintes status, não é possível realizar a alteração de status novamente e o cartão vai ser desativado: LOST, ROBBED, EXPIRED, DAMAGED, FRAUD, CANCELED, DELETED, BROKEN, THEFT e DEFECT.