Embossing

A API Embossing gerencia o embossing e a impressão dos cartões plásticos. A solicitação para um novo cartão ocorre no momento de aprovação do crédito do portador e é gerenciada pela plataforma de captação. Já a solicitação de impressão de uma segunda via vêm do módulo de atendimento ao cliente.

O processo de embossing pode ser feito em loja ou em gráfica.

Figura 1. Diagrama dos processos de embossing através da API Embossing

Embossing em loja:
Todo processo ocorre via API, onde é possível visualizar os cartões pendentes de embossing, coletar as informações necessárias e encaminhar para impressão ou loja desejada.

O embossing em loja pode ser feito em cada estabelecimento lojista ou um estabelecimento lojista específico ("central de distribuição").

O controle da impressora é de responsabilidade da loja e do parceiro de embossing, deixando o processo mais flexível e independente.

Embossing em gráfica:
As informações são coletadas via API, os dados sensíveis são criptografados, e todo o conteúdo é repassado pelo parceiro para gráfica de interesse.

Autenticação e segurança

A API utiliza OAuth 2 como protocolo de segurança junto de um Json Web Token (JWT). Para saber mais detalhes, confira a documentação técnica de autenticação.

Serviços e endpoints

Impressão do cartão

Após o onboarding e aprovação de crédito do portador, a solicitação para embossing do cartão entra na fila de impressão utilizando o endpoint:

Tipo	Endpoint	Documentação
`PATCH`	`/api/v1/embossing/cartoes/{id}`	Adiciona cartão na fila de impressão

Cartões pendentes

Para visualização de todos os cartões na fila de espera do embossing, a partir da data de geração da solicitação, utilize o endpoint:

Tipo	Endpoint	Documentação
`GET`	`/api/v1/embossing/cartoes/pendentes`	Visualiza os cartões na fila de impressão

Bloqueio do cartão

Caso haja alguma falha na impressão, utilize o endpoint abaixo para bloqueio permanente do cartão:

Tipo	Endpoint	Documentação
`POST`	`/api/v1/embossing/cartoes/{id}/bloqueio-falha`	Bloqueia o cartão por falha

Gerenciamento de impressoras

Gerencia a ativação e inativação das impressoras a partir do seu identificador.

Tipo	Endpoint	Documentação
`PATCH`	`/api/v1/embossing/impressoras/{id}/ativacao`	Ativar impressora
`PATCH`	`/api/v1/embossing/impressoras/{id}/inativacao`	Inativa a impressora

Os endpoints irão retornar os dados que podem ser acessados de acordo com suas credenciais de autenticação. Para mais informações, visite a página de autenticação.