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.
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 about 2 months ago