Skip to main content
POST
Solicitar Network Token
O Network Token é uma credencial emitida pela bandeira (Visa/Mastercard) que substitui o número real do cartão nos pagamentos. Habilitá-lo em um cartão salvo traz:
  • Maior taxa de autorização — o emissor confia mais no token da rede.
  • Menos exposição — o PAN real não trafega nas cobranças seguintes.
  • Atualização automática — quando o cliente troca de cartão (reemissão), o token continua válido, reduzindo falhas em recorrência.
Suportado apenas por Visa e Mastercard. Cartões Elo, Hipercard e outros continuam funcionando normalmente por tokenização comum, mas não têm Network Token.

Pré-requisito

O cartão já precisa existir (veja Tokenizar Cartão). Esta rota opera sobre um cartão salvo, identificado pelo seu uuid.

Parâmetro

string
required
O uuid do cartão salvo em que o Network Token será habilitado.
Não há corpo de requisição.
cURL

Resposta

Em caso de sucesso (200), a resposta é o próprio cartão, agora com o Network Token habilitado.
object
Presente quando o Network Token foi habilitado com sucesso.
200
Se a bandeira não habilitar o token (cartão não elegível, indisponibilidade momentânea), a resposta é 417 Expectation Failed. O cartão segue utilizável por tokenização comum — você pode tentar habilitar novamente mais tarde.
417