Tipos de Cartão Disponíveis
Atualmente, a operação permite trabalhar com dois modelos de cartão:
Cartão Nominal;
Cartão No Name.
Cada modelo possui particularidades operacionais, logísticas e de distribuição.
Cartão Nominal
O cartão nominal é emitido com o nome do titular impresso no plástico.
Esse modelo é indicado para operações onde o usuário final solicita e recebe o cartão diretamente em seu endereço.
Como funciona o fluxo
O usuário solicita o cartão pelo aplicativo;
A solicitação pode:
ser aprovada automaticamente; ou
depender de aprovação manual via Backoffice.
Após aprovação, a solicitação é enviada para a processadora/bandeira;
A embossadora recebe o pedido e realiza a produção;
O cartão é enviado diretamente para o endereço cadastrado pelo usuário.
Pontos importantes
O parceiro não recebe o estoque do cartão;
A entrega é feita diretamente ao usuário final;
O fluxo depende do prazo operacional da embossadora;
Cartão No Name
O cartão No Name não possui nome impresso e pode ser associado posteriormente a qualquer conta ativa.
Como funciona o fluxo
O parceiro solicita um lote de cartões via Backoffice;
O lote pode ser parcial ou integral;
O parceiro recebe os cartões;
A distribuição aos usuários finais fica sob responsabilidade do parceiro;
O usuário associa o cartão à conta pelo aplicativo.
Pontos importantes
O parceiro é responsável pela logística e armazenamento;
O cartão pode ser associado após a entrega;
O mesmo lote pode ser distribuído para diferentes empresas ou usuários;
Associação de Cartão No Name
A associação do cartão pode ser realizada pelo aplicativo ou via API.
Associação pelo aplicativo
Fluxo realizado pelo usuário final:
Acessar a área de cartões;
Selecionar “Associar cartão”;
Escanear o QR Code do cartão;
Informar a senha de acesso;
O cartão será vinculado automaticamente à conta.
Situações comuns
QR Code não reconhecido
Validar:
se o cartão já foi associado anteriormente;
qualidade da leitura da câmera;
Conta sem permissão para associação
Verificar:
se a conta está ativa;
se o produto cartão está habilitado;
se existem bloqueios operacionais na conta.
Associação via API
Também é possível realizar a associação programaticamente.
Rotas disponíveis
GET /cards/v2/searchPOST /cards/v2/associate
Fluxo recomendado
Consultar os dados do cartão;
Validar disponibilidade;
Realizar associação à conta desejada.
Cartão Virtual
O cartão virtual possui fluxo independente do cartão físico.
Isso significa que:
não é necessário possuir cartão físico para criar um virtual;
o usuário pode possuir apenas cartão virtual;
físico e virtual podem coexistir na mesma conta.
Benefícios operacionais
Maior flexibilidade;
Disponibilização imediata ao usuário;
Redução de dependência logística;
Melhor experiência digital.
Gestão de Cartões via API
As configurações do cartão podem ser gerenciadas via API através da rota:
card/settings
Funcionalidades disponíveis
É possível ativar ou desativar:
compras online;
compras internacionais;
pagamento por aproximação;
pagamento via tarja magnética.
Cancelamento de Cartão
O cancelamento pode ser realizado via rota administrativa, BackOffice e pelo aplicativo.
Via API - Endpoint disponível
DELETE /v2/admin/cards/{card_id}
Via BackOffice - Rota disponível
Acessar o cartão, verificar em ações a opção de cancelar cartão e bloquear cartão.
O que pode ser cancelado
Cartões físicos;
Cartões virtuais.
Quando utilizar
Perda ou roubo;
Suspeita de fraude;
Encerramento de conta;
Substituição de cartão;
Inutilização operacional.
No bloqueio, você só precisa informar o motivo.
Como efetuar o desbloqueio?
No desbloqueio pelo aplicativo, solicitamos apenas o PIN para validação.
No desbloqueio via BackOffice, basta utilizar a ação de "Ativar cartão"
Boas práticas operacionais
Recomendamos que os operadores:
validem sempre o status da conta antes de associar cartões;
controlem o estoque físico de cartões No Name;
acompanhem solicitações pendentes no Backoffice;
realizem bloqueio imediatamente em casos de suspeita de fraude, e caso confirmado o cancelamento;
orientem os usuários a manterem os dados cadastrais atualizados para entrega correta dos cartões nominais.
Considerações Finais
Os fluxos de cartões foram estruturados para oferecer maior autonomia operacional aos parceiros, permitindo que grande parte das ações do dia a dia seja realizada sem necessidade de acionamento do suporte.
Em casos de problemas operacionais, falhas sistêmicas ou comportamentos fora do fluxo esperado, recomendamos validar inicialmente:
Status da conta;
Status do cartão;
Permissões configuradas;
possíveis bloqueios operacionais.
Saldo em conta
Persistindo o cenário após as validações, o suporte poderá ser acionado com as evidências e informações técnicas necessárias para análise.