Emissão de cartão

A emissão de cartão é o ponto de partida da Gestão de Cartões. Antes de chamar qualquer endpoint específico, você precisa entender dois conceitos: o programa que define as regras dos seus cartões, e o fluxo de status que cada cartão percorre após a emissão.

Para que serve

Permite ao parceiro emitir cartões físicos e virtuais para os clientes, pré-pagos ou pós-pagos, conforme o programa.

Pré-requisitos

• Um programa de cartões definido com o time Bankly.
• Para a função débito: o cliente do parceiro deve possuir uma conta ativa (visão geral de Gestão da Conta).
• Para a função crédito: basta que o cliente possua um contrato de crédito criado (a conta ativa não é obrigatória nesse caso).

Definição de programa

Um programa é um conjunto de regras que define o comportamento de um grupo de cartões, modalidade (débito ou crédito), design do plástico, limites por tipo, entre outros parâmetros.

O parceiro define o programa preenchendo o Formulário de Cadastro de Programa com base no seu modelo de negócio. Depois disso, o time de Implantação Bankly retorna o identificador do programa (programId), que é usado em todos os endpoints de emissão.

Fluxo de emissão

1. Solicitação: o parceiro chama o endpoint de emissão correspondente ao tipo de cartão, enviando dados de senha, nome, documento, apelido, agência, conta, endereço de entrega (físicos) e programId.
2. Validação: o Bankly verifica autenticação, dados do cliente, conta (quando aplicável) e programa, e o limite de cartões ativos por tipo.
3. Status inicial Building: o cartão é registrado no sistema, e essa informação retorna ao parceiro. Em paralelo, os dados do físico vão para a confecção.
4. Transição:
   • Físico → status passa a InTransitLocked enquanto aguarda o cliente desbloquear.
   • Virtual → fica automaticamente Active após a emissão.

Os endpoints de emissão funcionam tanto para cartões pré-pagos quanto pós-pagos, a diferença está no programa.

Endpoints de emissão disponíveis

• Emissão de cartão físico
• Emissão de cartão virtual
• Emissão de segunda via
• Embossing — opções de impressão para físicos.

Emissão de segunda via de cartão

Em caso de extravio, dano ou por solicitação do usuário final, você pode emitir uma segunda via de um cartão, utilizando as mesmas características da primeira via.

Por onde começar

1. Defina o programa com o time Bankly e obtenha o programId.
2. Garanta que o cliente atende aos pré-requisitos conforme a modalidade desejada (conta ativa para débito ou contrato de crédito para crédito).
3. Escolha o endpoint conforme o tipo de cartão.
4. Configure os webhooks para receber CARD_WAS_ISSUED.

Artigos relacionados

• Definições (tipos e modalidades de cartão)
• Possíveis status do cartão
• Ativação do cartão
• Eventos de Cartões (webhooks)