Skip to main content
Este endpoint permite solicitar manualmente a criação de um Network Token para um cartão já tokenizado. Normalmente, o Network Token é solicitado automaticamente ao criar cartões Visa e Mastercard, mas este endpoint permite reprocessar a solicitação caso necessário.

​
O que é Network Token?

Network Tokens são tokens dinâmicos gerados pelas bandeiras de cartão (Visa e Mastercard) que oferecem:
  • Maior taxa de aprovação em transações
  • Melhor segurança através de tokenização dinâmica
  • Atualização automática de dados de expiração
  • Redução de fraudes e chargebacks

​
Casos de Uso

  • 🔄 Reprocessar solicitação de Network Token que falhou
  • 🔧 Forçar criação de Network Token para cartões antigos
  • 📊 Migração de cartões para o sistema de Network Token
Importante: Este endpoint só funciona para cartões Visa e Mastercard. Outras bandeiras não suportam Network Token e retornarão erro.

​
Parâmetros de URL

​
card
string
required
UUID do cartão para o qual será solicitado o Network Token

​
Exemplo de Requisição

curl -X POST https://zeus-sandbox.autorizou.devv1/cards/enroll-network-token/card_def456ghi789jkl012 \
  -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc"

​
Resposta de Sucesso

​
Network Token Criado (200 OK)

Quando o Network Token é criado com sucesso: 
{
  "id": "card_def456ghi789jkl012",
  "customer_id": "cus_abc123def456ghi789",
  "holder": "JOAO SILVA",
  "brand": "visa",
  "first_6": "411111",
  "last_4": "1111",
  "exp_month": "12",
  "exp_year": "30",
  "created_at": "15/01/2024 10:35:00",
  "updated_at": "15/01/2024 14:22:00"
}
Processo Assíncrono: A criação do Network Token acontece em segundo plano. A resposta 200 OK indica que a solicitação foi aceita, mas o token pode levar alguns segundos para ser gerado e associado ao cartão.

​
Detalhes da Resposta

Os campos retornados são os mesmos do endpoint de Buscar Cartão:
CampoTipoDescrição
idstringUUID único do cartão
customer_idstringUUID do cliente proprietário
holderstringNome do portador do cartão
brandstringBandeira do cartão (visa ou mastercard)
first_6stringPrimeiros 6 dígitos do cartão (BIN)
last_4stringÚltimos 4 dígitos do cartão
exp_monthstringMês de expiração (MM)
exp_yearstringAno de expiração (YY) - apenas 2 dígitos
created_atstringData de criação no formato DD/MM/YYYY HH:mm:ss
updated_atstringData da última atualização
Verificação: Para verificar se o Network Token foi gerado com sucesso, você pode consultar o cartão novamente após alguns segundos usando o endpoint Buscar Cartão.

​
Códigos de Erro

Falha ao criar Network Token
{
  "message": "Cartão não pôde ser inscrito no Network Token"
}
Possíveis causas:
  • Cartão de bandeira não suportada (somente Visa e Mastercard)
  • Problemas de comunicação com VGS
  • Dados do cartão inválidos ou incompletos
  • Cartão já possui Network Token ativo
Cartão não encontrado
{
  "message": "Cartão não encontrado"
}
Possíveis causas:
  • UUID não existe
  • Cartão pertence a outro merchant
  • UUID malformado
UUID inválido
{
  "error": {
    "code": "invalid_uuid",
    "message": "UUID do cartão é inválido"
  }
}

​
Bandeiras Suportadas

BandeiraNetwork Token Suportado
Visa✅ Sim
Mastercard✅ Sim
Elo❌ Não
Hipercard❌ Não
Diners❌ Não
Discover❌ Não
JCB❌ Não
Amex❌ Não
Bandeiras não suportadas: Tentar criar Network Token para cartões de outras bandeiras resultará em erro 417 (Expectation Failed).

​
Processo de Criação do Network Token

  1. Validação: Sistema verifica se o cartão existe e é de bandeira suportada (Visa/Mastercard)
  2. Solicitação: Requisição é enviada ao VGS (Very Good Security) para criar o Network Token
  3. Processamento: VGS comunica-se com a bandeira do cartão para gerar o token
  4. Atualização: Quando aprovado, o Network Token é associado ao cartão no banco de dados
  5. Uso: Futuras transações podem utilizar o Network Token para melhor taxa de aprovação
VGS (Very Good Security): Utilizamos o VGS como nosso provedor de tokenização, garantindo conformidade PCI DSS e máxima segurança.

​
Quando Usar Este Endpoint

​
Casos Recomendados

✅ Cartão criado antes da implementação de Network Token
  • Cartões antigos que não têm Network Token podem se beneficiar
✅ Falha na criação automática
  • Se a criação automática falhou durante o cadastro do cartão
✅ Atualização de sistema
  • Após migrações ou mudanças de infraestrutura

​
Casos NÃO Recomendados

❌ Cartões recém-criados
  • A criação automática já foi tentada
❌ Cartões com Network Token ativo
  • Não é necessário reprocessar
❌ Bandeiras não suportadas
  • Resultará em erro

​
Segurança

PCI DSS: Este endpoint mantém conformidade PCI DSS. Nenhum dado sensível do cartão é exposto ou trafega em texto puro.
Auditoria: Todas as solicitações de Network Token são registradas para fins de auditoria e segurança.

​
Próximos Passos

Após solicitar o Network Token:
  1. Aguardar alguns segundos para processamento
  2. Buscar o cartão para verificar o status
  3. Processar pagamentos com melhor taxa de aprovação