Emissão de 2ª via de cartão

Para emitir a 2ª via de um cartão físico, utilize a API de reemissão.

A emissão de 2ª via deve ser utilizada quando houver necessidade de substituir um cartão físico existente.

Quando utilizar a 2ª via

A reemissão do cartão pode ser realizada nos seguintes casos:

Perda do cartão
Roubo
Suspeita ou ocorrência de fraude
Extravio
Cartão danificado ou defeituoso

🚧
Importante
A emissão de 2ª via está disponível apenas para cartões físicos.
Para cartões virtuais, deve ser utilizada a emissão de um novo cartão.

Notificação de emissão

Após a solicitação de reemissão, o cliente receberá webhooks relacionados ao ciclo de vida do cartão.

Eventos:

card-created → informa que o novo cartão foi gerado
card-in-transit → utilizado para acompanhar o envio do novo cartão físico

Esses eventos devem ser utilizados para acompanhar o processo de substituição do cartão.

Dados para reemissão

Para realizar a reemissão do cartão, é necessário informar os seguintes campos:

Campo	Tipo	Descrição
reasonId	int	Motivo da reemissão do cartão
contactlessEnabled	boolean	Indica se o cartão terá aproximação habilitada
abuEnabled	boolean	Indica se o serviço de atualização automática de cartões está habilitado
modeType	string	Define o tipo de emissão (`SINGLE` ou `COMBO`)
updateTokens	boolean	Indica se tokens existentes devem ser atualizados

Motivos de reemissão

ReasonId	Tipo	Descrição
1	Perda	Cartão perdido
2	Roubo	Cartão roubado
3	Fraude	Cartão comprometido por fraude
4	Extravio	Cartão extraviado
5	Defeito	Cartão danificado ou com defeito

Regras de reemissão

modeType = SINGLE → cartão com uma única função
modeType = COMBO → cartão multiapp (somente físico)

🚧
Importante
Ao emitir uma 2ª via:

O cartão anterior é automaticamente cancelado

O novo cartão passa a ser o único válido para uso

Consulta da reemissão

Após a solicitação, é possível consultar o status do novo cartão emitido.

Campo	Tipo	Descrição
id	int	Identificador do cartão
lastDigits	int	Últimos 4 dígitos do cartão
status	string	Status do cartão
function	string	Modalidade do cartão
bin	int	BIN do cartão
type	string	Tipo do cartão (`PLASTIC` ou `VIRTUAL`)
expirationDate	date	Data de expiração do cartão

Considerações importantes

A reemissão gera um novo cartão físico
O cartão anterior é cancelado automaticamente
O processo de envio segue o mesmo fluxo da emissão de cartão físico, realizando a geração do webhook.
É necessário um endereço de correspondência válido para entrega