> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autorizou.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Solicitar Network Token

> Habilita o Network Token (Visa/Mastercard) de um cartão já salvo

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.

<Note>
  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.
</Note>

## Pré-requisito

O cartão já precisa existir (veja [Tokenizar Cartão](/api-reference/cards/create-card)). Esta rota opera sobre um cartão salvo, identificado pelo seu `uuid`.

## Parâmetro

<ParamField path="card" type="string" required>
  O `uuid` do cartão salvo em que o Network Token será habilitado.
</ParamField>

Não há corpo de requisição.

```bash cURL theme={null}
curl -X POST "https://pay.autorizou.dev/api/v1/cards/enroll-network-token/card_def456ghi789jkl012" \
  -H "Authorization: Bearer SUA_CHAVE"
```

## Resposta

Em caso de sucesso (`200`), a resposta é o próprio cartão, agora com o Network Token habilitado.

<ResponseField name="network_token" type="object">
  Presente quando o Network Token foi habilitado com sucesso.
</ResponseField>

```json 200 theme={null}
{
  "id": "3f7d2a91-8c4e-4b6f-9a2d-5e8c1f4b7a30",
  "brand": "visa",
  "last_4": "1111",
  "holder": "JOAO SILVA",
  "network_token": {
    "enrolled": true
  }
}
```

<Warning>
  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.
</Warning>

```json 417 theme={null}
{
  "message": "Não foi possível habilitar o Network Token para este cartão."
}
```