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 24 days ago