Emissão/Geração de Cartão

Para emitir um cartão para o portador, utilize a API de emissão de cartões.

Tipos de emissão

Cartão físico → produção e envio ao portador
Cartão virtual → disponibilização imediata

Modalidades de cartão

Pré-pago
Pós-pago
Multiapp (apenas para cartões físicos)

🚧
Importante
No caso de multiapp virtual, para utilizar ambas as funções, é necessário emitir cartões separados:

Um cartão virtual para pré-pago

Um cartão virtual para pós-pago

Dados para emissão

Para realizar a emissão, é necessário informar os seguintes campos:

Campo	Tipo	Descrição
name	string	Nome de identificação do cartão
printedName	string	Nome impresso no cartão
type	string	Tipo do cartão (`PLASTIC` ou `VIRTUAL`)
transactionLimit (opcional)	int	Limite máximo por transação
contactlessEnabled	boolean	Indica se pagamento por aproximação está habilitado
modeType	string	Define o tipo de emissão (`SINGLE` ou `COMBO`)

Regras de emissão

type = PLASTIC → cartão físico
type = VIRTUAL → cartão virtual
modeType = SINGLE → cartão com uma única função
modeType = COMBO → cartão físico multiapp

Notificação de emissão

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

Eventos:

card-created → utilizado para informar que o cartão foi criado
card-in-transit → utilizado para acompanhar o rastreio de envio do cartão físico

Esses webhooks devem ser utilizados para acompanhar o status do cartão e dar sequência ao fluxo de negócio no sistema do cliente.

Considerações importantes

Cartões virtuais são disponibilizados imediatamente após emissão
Cartões físicos dependem de produção e entrega
A emissão depende de conta cartão ativa
Para cartões físicos, é necessário endereço de correspondência válido