Tokenização

POST/v1/cards/tokenization

Endpoint em Descontinuação — Este endpoint foi descontinuado em Agosto/2025. Por favor, migre para a nova solução disponível em Bibliotecas de Segurança.

A tokenização substitui os dados confidenciais de um cartão por um token único, garantindo que informações sensíveis não sejam expostas durante o processamento.

Gerar Token

Parâmetros

Exemplo de requisição

{
  "cardNumber": "4111111111111111"
}

Retorno (200)

Exemplo de resposta

[
  {
    "numberToken": "4DB5E9B5-F30E-4416-8E41-20B539426B68"
  }
]

Dicionário de dados

Erros

As respostas de erro conhecidas estão abaixo. Os retornos observados em homologação estão identificados separadamente dos exemplos documentados; as respostas podem variar conforme o ambiente e a configuração.

Exemplo documentado

[
  {
    "tag": "CardNumber",
    "description": "Cartão inválido."
  }
]

Observado em homologação

Requisição com corpo JSON vazio ou identificador sintético. O retorno abaixo mostra a validação realizada em homologação.

[
  {
    "tag": "CardNumber",
    "description": "O identificador de recorrência é obrigatório."
  }
]

Campos da resposta de erro

A tabela reúne os campos presentes nos exemplos acima. Uma resposta HTTP sem corpo não inclui esses campos.