Alteração de status
Altere o status atual de um cartão, realizando bloqueio ou desativando o cartão definitivamente.
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 -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
| 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 atrelados a um cartão, são os seguintes:
| Status | Id do Status | Descrição |
|---|---|---|
| CREATED | 1 | Criado no sistema. |
| UNBOUND | 2 | Cartão Noname ainda não atribuído ao cliente. |
| NORMAL | 3 | Ativo e elegível para transações. Padrão para cartões virtuais. |
| REISSUED | 4 | O cartão foi reemitido |
| BLOCKED | 5 | Temporariamente 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. |
| PENDING | 6 | Criado e pendente até processamento posterior, como verificação de conta. Até lá, as transações estão desativadas. |
| WARNING | 7 | Um 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 |
| LOST | 8 | Perda relatada |
| ROBBED | 9 | Denúncia de roubo |
| EXPIRED | 10 | Expiração da data do cartão atingida |
| DAMAGED | 11 | Avariado |
| FRAUD | 12 | Suspeita de fraude |
| CANCELED | 13 | Cancelado |
| DELETED | 14 | Deletado |
| BROKEN | 15 | Não é mais fisicamente utilizável |
| THEFT | 16 | Roubado |
| DEFECT | 17 | Tem 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.
Updated 2 days ago