Bloqueio de segurança do cartão

Em determinados cenários, um cartão pode ser bloqueado automaticamente pelo sistema. Esse bloqueio é uma medida de segurança para evitar tentativas de fraude ou uso indevido. Quando isso acontece, a plataforma envia um webhook através da entidade issuing-card/log, informando a mudança de status do cartão. É importante que a empresa acompanhe esses eventos para garantir uma boa experiência do usuário e agir rapidamente em casos de necessidade.

Quando o cartão é bloqueado, você receberá um webhook com as seguintes características:

• status: blocked

• type: status (indica alteração de status)

• reason: geralmente vazio, mas os principais motivos são:

  • Bloqueio manual solicitado por você;

  • Bloqueio automático após 4 ou mais tentativas falhas do usuário, com erros como:

    • invalidPin

    • invalidExpiration

    • invalidSecurityCode

    • invalidPaymentMethod

O bloqueio automático é ativado como medida de segurança contra potenciais fraudes.

Existem duas formas de acompanhar o status de um cartão:

1. Consultar o cartão diretamente

GET /v2/issuing-card/:id

2. Consultar os logs do cartão

GET /v2/issuing-card/logs?cardIds=<id>

3. Caso o bloqueio tenha sido resolvido e o cartão precise ser reativado, basta enviar:

PATCH /v2/issuing-card/:id
{
  "status": "active"
}