Alteração de status

É possível realizar alterações no status de um cartão, como bloqueio e desbloqueio temporário ou mesmo cancelamento definitivo do cartão.

Para cartões Multiapp, a alteração do status de um cartão, será automaticamente refletida no outro. Com exceção da ativação do cartão, que deverá ser realizada individualmente para cada cartão, crédito e pré-pago débito.

Todos os possíveis status de um cartão estão listados abaixo.

Passos para Integrar

Realizar autenticação na API
Ter um cartão emitido na Celcoin
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 --request PUT \
  --url https://sandbox-apicorp.celcoin.com.br/cards/v1/accounts/310/customers/195/card/2040/status \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --header 'User-Agent: insomnia/10.0.0' \
  --data '{
  "status": "NORMAL"
}'

👍
Sucesso 200

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

Significado dos objetos

Campo	Tipo	Descrição
id	int	Id do cartão gerado na emissão
statusid	int	Status em que o cartão se encontra
status	string(10)	Descrição do status que o cartão se encontra

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

Status	Descrição
CREATED	Criado no sistema
NORMAL	Ativo e elegível para transações. Padrão para cartões virtuais.
REISSUED	O cartão foi reemitido
BLOCKED	Temporariamente bloqueado. Um cartão pode ser bloqueado, por exemplo, se o titular do cartão tiver excedido suas tentativas permitidas de inserir uma senha.
PENDING	Cartão em processo de criação. Esse status ocorre entre o momento da solicitação e efetivação da criação de cartão.
WARNING	Um sinalizador de alerta geral é definido e as transações são desabilitadas, geralmente em casos de suspeita de fraude.
LOST	Perda relatada
ROBBED	Status em casos de roubo
EXPIRED	Cartão com data de expiração vencida
DAMAGED	Avariado
FRAUD	Suspeita de fraude
CANCELED	Cancelado
DELETED	Deletado
BROKEN	Não é mais fisicamente utilizável
THEFT	Status em casos de roubo
DEFECT	Defeito

🚧
Atenção!
Os status a seguir são irreversíveis e tornam o cartão inutilizável: LOST, ROBBED, EXPIRED, DAMAGED, FRAUD, CANCELED, DELETED, BROKEN, THEFT e DEFECT.

Updated 15 days ago