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

# Cartão salvo

> Cobre as próximas compras do cliente com um clique, usando um cartão já guardado no cofre da Finvia e pedindo só o CVV.

Esta página trata da **cobrança** com um cartão que já está guardado. O cadastro e a gestão dos cartões (registrar, consultar status, listar e excluir) estão em [Cofre de cartões](https://docs.fastpaybrasil.com/guias/cofre-de-cartoes.md).

Com o cartão salvo, o cliente digita os dados do cartão uma única vez. Nas compras seguintes, o seu checkout mostra o cartão mascarado (ex.: `****1111`), o cliente informa só o CVV e a cobrança é feita com o identificador do cartão (`cardTokenId`).

> [!NOTE]
>
> **Para o negócio:** o cartão salvo encurta o checkout de quem compra de novo, porque o cliente não precisa digitar número, nome e validade. O CVV continua sendo pedido em toda compra: esta forma de pagamento é para compras com o cliente presente. Para cobrar automaticamente todo mês, use Assinaturas.

> [!WARNING]
>
> O cofre de cartões é **o mesmo para teste e produção**. Um `cardTokenId` criado durante a homologação também funciona com a chave de produção, e aí a mesma chamada cobra de verdade. Controle no seu sistema qual chave cada ambiente usa.

## Quando usar

| Situação | Use cartão salvo? | Alternativa |
| - | - | - |
| Recompra em loja virtual (refil, consumíveis, delivery) | Sim | |
| Upgrade ou compra adicional dentro de um app ou plataforma | Sim | |
| Cobrança mensal fixa, sem o cliente presente | Não | [Assinaturas](https://docs.fastpaybrasil.com/guias/assinaturas/visao-geral.md) |
| Cobrança recorrente iniciada pela sua empresa | Não | [Assinaturas](https://docs.fastpaybrasil.com/guias/assinaturas/visao-geral.md) |
| Primeira compra, sem cartão guardado | Não | [Cartão de crédito](https://docs.fastpaybrasil.com/guias/cobrancas/cartao-de-credito.md) |

### Cartão salvo ou assinatura?

| | Cartão salvo | Assinatura |
| - | - | - |
| Quem inicia a cobrança | O cliente, no seu checkout | A Finvia, a cada ciclo do plano |
| CVV | Obrigatório em toda cobrança | Não é pedido a cada ciclo |
| Valor | Livre, definido em cada cobrança | Definido pelo plano |
| Rota | `POST /v1/charges` com `cardTokenId` | `POST /v1/subscriptions` |
| Uso típico | Recompra com um clique | Mensalidade, clube, SaaS |

Os dois usam o mesmo cartão registrado: o `id` devolvido por `POST /v1/cards` serve tanto para a cobrança com um clique quanto para criar uma assinatura.

## Como funciona

O desenho abaixo mostra as duas fases: guardar o cartão uma vez e, nas compras seguintes, cobrar pedindo só o CVV.

```mermaid placement="top-right" className="finvia-diagrama" theme={null}
%%{init: {"theme": "base", "fontFamily": "Inter, sans-serif", "themeVariables": {"fontFamily": "Inter, Arial, sans-serif", "fontSize": "15px", "primaryColor": "#EAF3FF", "primaryBorderColor": "#017AFF", "primaryTextColor": "#070D15", "secondaryColor": "#F3F5F8", "tertiaryColor": "#FFFFFF", "lineColor": "#5B6B82", "textColor": "#070D15", "edgeLabelBackground": "#FFFFFF", "clusterBkg": "#F7F9FC", "clusterBorder": "#D5DCE6", "actorBkg": "#FFFFFF", "actorBorder": "#98A2B3", "actorTextColor": "#070D15", "actorLineColor": "#B8C2D1", "signalTextColor": "#070D15", "labelBoxBkgColor": "#EAF3FF", "labelBoxBorderColor": "#017AFF", "labelTextColor": "#003A7A", "loopTextColor": "#070D15", "noteBkgColor": "#FFF6E5", "noteBorderColor": "#F0B44C", "noteTextColor": "#5C3D00", "activationBkgColor": "#EAF3FF", "activationBorderColor": "#017AFF", "sequenceNumberColor": "#FFFFFF", "signalColor": "#5B6B82"}, "flowchart": {"curve": "basis", "nodeSpacing": 45, "rankSpacing": 55, "padding": 18}, "sequence": {"mirrorActors": false, "showSequenceNumbers": true, "actorMargin": 60, "messageMargin": 38, "boxMargin": 10, "noteMargin": 12, "wrap": true}}}%%
sequenceDiagram
    autonumber
    box rgb(255,246,229) Comprador
        participant C as Comprador
    end
    box rgb(243,245,248) Sua aplicação
        participant L as Seu checkout e servidor
    end
    box rgb(234,243,255) Finvia
        participant F as Finvia API e cofre
    end
    box rgb(244,240,255) Fora da Finvia
        participant E as Adquirente e emissor
    end
    Note over C,E: Uma única vez · guardar o cartão no cofre
    C->>L: Digita número, nome, validade e CVV
    L->>F: POST /v1/cards · customerId + dados do cartão
    F->>E: Registra o cartão, sem cobrar nada
    F-->>L: 201 · id (o cardTokenId) · maskedNumber
    L->>L: Grava só o id e o ****1111
    Note over C,E: Nas próximas compras · cobrar com um clique
    L->>F: GET /v1/cards?customerId=...
    F-->>L: Cartões do cliente · use só os active
    L-->>C: Mostra o cartão ****1111 e pede o CVV
    C->>L: Digita só o CVV
    L->>F: POST /v1/charges · cardTokenId + cvv + installments
    F->>E: Pede a autorização
    F-->>L: 201 · paid, refused ou failed · motivo em reason
    L-->>C: Confirma o pedido ou oferece outro cartão ou Pix
```

O cadastro do cartão não tem modo de teste e não cobra nada. Com a chave `sk_test_`, só a cobrança da segunda fase é simulada.

**1. Tenha um cartão ativo no cofre**

O cartão foi registrado com `POST /v1/cards` e já nasce `active`. O cadastro não faz nenhuma cobrança nem transação de validação. O seu sistema guardou o `id` do cartão e o número mascarado. Veja [Cofre de cartões](https://docs.fastpaybrasil.com/guias/cofre-de-cartoes.md).

**2. Na recompra, peça só o CVV**

O checkout mostra o cartão mascarado e o cliente digita o CVV.

**3. Cobre com cardTokenId e cvv**

Seu servidor chama `POST /v1/charges` com `paymentMethod.type` `credit_card`, `cardTokenId`, `cvv` e `installments`.

**4. Leia o resultado na resposta**

O resultado volta na resposta, como no cartão digitado: `paid`, `refused` ou `failed`, com o motivo em `reason`.

## Regras de negócio

| Regra | Detalhe |
| - | - |
| CVV | Obrigatório em toda cobrança com `cardTokenId`, mínimo de 3 caracteres. Sem ele: `400` `CVV is required when using cardTokenId` |
| Cartão utilizável | Cartão revogado (excluído) ou expirado recebe `400` |
| Identificador | O `cardTokenId` é o campo `id` da resposta de `POST /v1/cards` (não o campo `token`) |
| Dono do cartão | O cartão pertence ao merchant da chave que o registrou e não pode ser usado por outro merchant ou subconta |
| Parcelas | `installments` obrigatório, de `1` a `12` |
| Dados do cartão | Com `cardTokenId`, os campos `number`, `holderName`, `expirationMonth` e `expirationYear` não são necessários |

> [!WARNING]
>
> A cobrança com cartão salvo não acontece com o cliente ausente. Se o seu modelo é cobrar todo mês sem o cliente digitar o CVV, use [Assinaturas](https://docs.fastpaybrasil.com/guias/assinaturas/visao-geral.md).

> [!TIP]
>
> **Para o desenvolvedor:** não armazene o CVV. Peça ao cliente que digite o código a cada compra e envie direto na requisição.

### Modo Teste

| O que você faz com a chave `sk_test_` | O que acontece |
| - | - |
| Cobrança com `cardTokenId` (`POST /v1/charges`) | É **simulada** e não movimenta dinheiro. O resultado segue as regras dos [cartões de teste](https://docs.fastpaybrasil.com/guias/cobrancas/cartao-de-credito.md#cartões-de-teste) aplicadas ao número guardado. Como o cartão salvo normalmente é real, a cobrança de teste costuma sair `paid` |
| Cadastro do cartão (`POST /v1/cards`) | Não tem modo de teste: o cartão é guardado no cofre e registrado na adquirente de verdade, mas **nada é cobrado** |
| Assinaturas | Não têm modo de teste: as cobranças são reais, inclusive a validação de R\$ 1,00 do trial grátis |

Para testar uma recusa no sandbox, use a cobrança com cartão digitado e o cartão de recusa `4444333322221112`.

## Passo a passo

### 1. Confirme que o cartão pode ser usado

Antes de oferecer o cartão no checkout, liste os cartões do cliente com [`GET /v1/cards?customerId=...`](https://docs.fastpaybrasil.com/referencia/cartoes/listar) e mostre só os que estão `active`. A cobrança recusa cartão `revoked` ou `expired`. Use a listagem, e não a consulta individual: hoje a consulta pode mostrar `active` para um cartão já excluído ou vencido. Detalhes em [Cofre de cartões](https://docs.fastpaybrasil.com/guias/cofre-de-cartoes.md).

### 2. Cobre com um clique

```http REST (JSON) theme={null}
POST /v1/charges HTTP/1.1
Host: api-global.fastpaybrasil.com
Authorization: Basic <base64 de "SUA_CHAVE_SECRETA:">
Content-Type: application/json

{
  "amount": 89.9,
  "currency": "BRL",
  "customer": {
    "id": "2vorkDcXyvzifL63YX09S9VqcnI"
  },
  "paymentMethod": {
    "type": "credit_card",
    "cardTokenId": "36OO3bcGjhPjjF3tzrqOGcmQuKo",
    "cvv": "123",
    "installments": 1
  },
  "items": [
    {
      "title": "Refil de filtro",
      "type": "physical",
      "description": "Refil trimestral",
      "unit_price": 89.9,
      "quantity": 1
    }
  ],
  "shippingAddress": {
    "postalCode": "01310100",
    "addressLine1": "Av. Paulista, 1000",
    "addressLine2": "Apto 51",
    "neighborhood": "Bela Vista",
    "city": "São Paulo",
    "state": "SP",
    "country": "BRA"
  },
  "postbackUrl": "https://meusite.com.br/webhooks/finvia"
}
```

```bash cURL theme={null}
curl -X POST "https://api-global.fastpaybrasil.com/v1/charges" \
  -u "$FINVIA_API_KEY:" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 89.9,
    "currency": "BRL",
    "customer": { "id": "2vorkDcXyvzifL63YX09S9VqcnI" },
    "paymentMethod": {
      "type": "credit_card",
      "cardTokenId": "36OO3bcGjhPjjF3tzrqOGcmQuKo",
      "cvv": "123",
      "installments": 1
    },
    "items": [
      { "title": "Refil de filtro", "type": "physical", "description": "Refil trimestral", "unit_price": 89.9, "quantity": 1 }
    ],
    "shippingAddress": {
      "postalCode": "01310100",
      "addressLine1": "Av. Paulista, 1000",
      "addressLine2": "Apto 51",
      "neighborhood": "Bela Vista",
      "city": "São Paulo",
      "state": "SP",
      "country": "BRA"
    },
    "postbackUrl": "https://meusite.com.br/webhooks/finvia"
  }'
```

```javascript Node.js theme={null}
// cobrar-cartao-salvo.mjs (Node.js 18+, ESM)
const API_URL = 'https://api-global.fastpaybrasil.com';
const credentials = Buffer.from(`${process.env.FINVIA_API_KEY}:`).toString('base64');

async function cobrarCartaoSalvo({ customerId, cardTokenId, cvv, pedido }) {
  const response = await fetch(`${API_URL}/v1/charges`, {
    method: 'POST',
    headers: { Authorization: `Basic ${credentials}`, 'Content-Type': 'application/json' },
    body: JSON.stringify({
      amount: pedido.total,
      currency: 'BRL',
      customer: { id: customerId },
      paymentMethod: { type: 'credit_card', cardTokenId, cvv, installments: 1 },
      items: pedido.itens,
      shippingAddress: pedido.endereco,
      postbackUrl: 'https://meusite.com.br/webhooks/finvia',
    }),
  });
  return response.json(); // status: paid, refused ou failed, com reason
}

const charge = await cobrarCartaoSalvo({
  customerId: '2vorkDcXyvzifL63YX09S9VqcnI',
  cardTokenId: '36OO3bcGjhPjjF3tzrqOGcmQuKo',
  cvv: '123', // digitado pelo cliente nesta compra
  pedido: {
    total: 89.9,
    itens: [{ title: 'Refil de filtro', type: 'physical', description: 'Refil trimestral', unit_price: 89.9, quantity: 1 }],
    endereco: {
      postalCode: '01310100',
      addressLine1: 'Av. Paulista, 1000',
      addressLine2: 'Apto 51',
      neighborhood: 'Bela Vista',
      city: 'São Paulo',
      state: 'SP',
      country: 'BRA',
    },
  },
});
console.log(charge.id, charge.status, charge.reason);
```

```python Python theme={null}
import os

import requests

payload = {
    "amount": 89.9,
    "currency": "BRL",
    "customer": {
        "id": "2vorkDcXyvzifL63YX09S9VqcnI",
    },
    "paymentMethod": {
        "type": "credit_card",
        "cardTokenId": "36OO3bcGjhPjjF3tzrqOGcmQuKo",
        "cvv": "123",
        "installments": 1,
    },
    "items": [
        {
            "title": "Refil de filtro",
            "type": "physical",
            "description": "Refil trimestral",
            "unit_price": 89.9,
            "quantity": 1,
        },
    ],
    "shippingAddress": {
        "postalCode": "01310100",
        "addressLine1": "Av. Paulista, 1000",
        "addressLine2": "Apto 51",
        "neighborhood": "Bela Vista",
        "city": "São Paulo",
        "state": "SP",
        "country": "BRA",
    },
    "postbackUrl": "https://meusite.com.br/webhooks/finvia",
}

response = requests.request(
    "POST",
    "https://api-global.fastpaybrasil.com/v1/charges",
    auth=(os.environ["FINVIA_API_KEY"], ""),
    json=payload,
    timeout=30,
)

print(response.status_code)
if response.content:
    print(response.json())
```

```php PHP theme={null}
<?php

$payload = [
    'amount' => 89.9,
    'currency' => 'BRL',
    'customer' => [
        'id' => '2vorkDcXyvzifL63YX09S9VqcnI',
    ],
    'paymentMethod' => [
        'type' => 'credit_card',
        'cardTokenId' => '36OO3bcGjhPjjF3tzrqOGcmQuKo',
        'cvv' => '123',
        'installments' => 1,
    ],
    'items' => [
        [
            'title' => 'Refil de filtro',
            'type' => 'physical',
            'description' => 'Refil trimestral',
            'unit_price' => 89.9,
            'quantity' => 1,
        ],
    ],
    'shippingAddress' => [
        'postalCode' => '01310100',
        'addressLine1' => 'Av. Paulista, 1000',
        'addressLine2' => 'Apto 51',
        'neighborhood' => 'Bela Vista',
        'city' => 'São Paulo',
        'state' => 'SP',
        'country' => 'BRA',
    ],
    'postbackUrl' => 'https://meusite.com.br/webhooks/finvia',
];

$ch = curl_init('https://api-global.fastpaybrasil.com/v1/charges');

curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD => getenv('FINVIA_API_KEY') . ':',
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);

$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $status, PHP_EOL;
print_r(json_decode($body, true));
```

```java Java theme={null}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;

public class Exemplo {
    public static void main(String[] args) throws Exception {
        String credentials = Base64.getEncoder()
            .encodeToString((System.getenv("FINVIA_API_KEY") + ":").getBytes());

        String payload = """
            {
              "amount": 89.9,
              "currency": "BRL",
              "customer": {
                "id": "2vorkDcXyvzifL63YX09S9VqcnI"
              },
              "paymentMethod": {
                "type": "credit_card",
                "cardTokenId": "36OO3bcGjhPjjF3tzrqOGcmQuKo",
                "cvv": "123",
                "installments": 1
              },
              "items": [
                {
                  "title": "Refil de filtro",
                  "type": "physical",
                  "description": "Refil trimestral",
                  "unit_price": 89.9,
                  "quantity": 1
                }
              ],
              "shippingAddress": {
                "postalCode": "01310100",
                "addressLine1": "Av. Paulista, 1000",
                "addressLine2": "Apto 51",
                "neighborhood": "Bela Vista",
                "city": "São Paulo",
                "state": "SP",
                "country": "BRA"
              },
              "postbackUrl": "https://meusite.com.br/webhooks/finvia"
            }
            """;

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api-global.fastpaybrasil.com/v1/charges"))
            .header("Authorization", "Basic " + credentials)
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}
```

```csharp C# theme={null}
using System.Net.Http.Headers;
using System.Text;

var apiKey = Environment.GetEnvironmentVariable("FINVIA_API_KEY");
var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($"{apiKey}:"));

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", credentials);

var payload = """
{
  "amount": 89.9,
  "currency": "BRL",
  "customer": {
    "id": "2vorkDcXyvzifL63YX09S9VqcnI"
  },
  "paymentMethod": {
    "type": "credit_card",
    "cardTokenId": "36OO3bcGjhPjjF3tzrqOGcmQuKo",
    "cvv": "123",
    "installments": 1
  },
  "items": [
    {
      "title": "Refil de filtro",
      "type": "physical",
      "description": "Refil trimestral",
      "unit_price": 89.9,
      "quantity": 1
    }
  ],
  "shippingAddress": {
    "postalCode": "01310100",
    "addressLine1": "Av. Paulista, 1000",
    "addressLine2": "Apto 51",
    "neighborhood": "Bela Vista",
    "city": "São Paulo",
    "state": "SP",
    "country": "BRA"
  },
  "postbackUrl": "https://meusite.com.br/webhooks/finvia"
}
""";

var request = new HttpRequestMessage(HttpMethod.Post, "https://api-global.fastpaybrasil.com/v1/charges");
request.Content = new StringContent(payload, Encoding.UTF8, "application/json");

var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

```go Go theme={null}
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
	"strings"
)

func main() {
	payload := strings.NewReader(`{
	  "amount": 89.9,
	  "currency": "BRL",
	  "customer": {
	    "id": "2vorkDcXyvzifL63YX09S9VqcnI"
	  },
	  "paymentMethod": {
	    "type": "credit_card",
	    "cardTokenId": "36OO3bcGjhPjjF3tzrqOGcmQuKo",
	    "cvv": "123",
	    "installments": 1
	  },
	  "items": [
	    {
	      "title": "Refil de filtro",
	      "type": "physical",
	      "description": "Refil trimestral",
	      "unit_price": 89.9,
	      "quantity": 1
	    }
	  ],
	  "shippingAddress": {
	    "postalCode": "01310100",
	    "addressLine1": "Av. Paulista, 1000",
	    "addressLine2": "Apto 51",
	    "neighborhood": "Bela Vista",
	    "city": "São Paulo",
	    "state": "SP",
	    "country": "BRA"
	  },
	  "postbackUrl": "https://meusite.com.br/webhooks/finvia"
	}`)

	req, err := http.NewRequest("POST", "https://api-global.fastpaybrasil.com/v1/charges", payload)
	if err != nil {
		panic(err)
	}
	req.SetBasicAuth(os.Getenv("FINVIA_API_KEY"), "")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode)
	fmt.Println(string(body))
}
```

```ruby Ruby theme={null}
require "json"
require "net/http"
require "uri"

uri = URI("https://api-global.fastpaybrasil.com/v1/charges")
request = Net::HTTP::Post.new(uri)
request.basic_auth(ENV.fetch("FINVIA_API_KEY"), "")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
  "amount" => 89.9,
  "currency" => "BRL",
  "customer" => {
    "id" => "2vorkDcXyvzifL63YX09S9VqcnI",
  },
  "paymentMethod" => {
    "type" => "credit_card",
    "cardTokenId" => "36OO3bcGjhPjjF3tzrqOGcmQuKo",
    "cvv" => "123",
    "installments" => 1,
  },
  "items" => [
    {
      "title" => "Refil de filtro",
      "type" => "physical",
      "description" => "Refil trimestral",
      "unit_price" => 89.9,
      "quantity" => 1,
    },
  ],
  "shippingAddress" => {
    "postalCode" => "01310100",
    "addressLine1" => "Av. Paulista, 1000",
    "addressLine2" => "Apto 51",
    "neighborhood" => "Bela Vista",
    "city" => "São Paulo",
    "state" => "SP",
    "country" => "BRA",
  },
  "postbackUrl" => "https://meusite.com.br/webhooks/finvia",
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.code
puts response.body
```

### 3. Trate o resultado

A resposta tem o mesmo formato da cobrança com cartão digitado: `id`, `status`, `paymentDetails` e `reason`. Libere o pedido só com `paid`. Em `refused`, mostre o motivo e ofereça outro cartão ou Pix. Detalhes em [Cartão de crédito](https://docs.fastpaybrasil.com/guias/cobrancas/cartao-de-credito.md).

## Erros comuns

| Sintoma | Causa | Como resolver |
| - | - | - |
| `400` `CVV is required when using cardTokenId` | `cvv` ausente | Peça o CVV ao cliente em toda compra |
| `400` com cartão salvo | Cartão revogado (excluído) ou expirado | Confira a listagem `GET /v1/cards?customerId=...` e peça um novo cartão |
| `status` `refused` com `reason` | Recusa do emissor ou do antifraude | Mostre o motivo e ofereça outro cartão ou Pix |
| Cartão não aceito em uma subconta | O cartão pertence ao merchant que o registrou | Registre o cartão com a chave da conta que vai cobrar |
| Cobrança real durante a homologação | `cardTokenId` de teste usado com a chave de produção | O cofre é compartilhado: separe as chaves por ambiente no seu sistema |

## Perguntas frequentes

> [accordion] Posso cobrar o cartão salvo sem pedir o CVV?
>
> Não. O CVV é obrigatório em toda cobrança com `cardTokenId`. Para cobrar sem o cliente presente, use [Assinaturas](https://docs.fastpaybrasil.com/guias/assinaturas/visao-geral.md), que dispensam o CVV na recorrência.

> [accordion] Posso parcelar uma compra com cartão salvo?
>
> Sim. Envie `installments` de `1` a `12`, como na cobrança com cartão digitado.

> [accordion] Uma subconta pode usar o cartão registrado pela conta master?
>
> Não. O cartão pertence ao merchant da chave que o registrou e só pode ser usado por ele.

> [accordion] O cadastro do cartão cobra algum valor do cliente?
>
> Não. `POST /v1/cards` guarda o cartão no cofre e o registra na adquirente sem nenhuma cobrança nem transação de validação. O cartão já nasce `active`.

> [accordion] Como testo sem cobrar de verdade?
>
> Com a chave `sk_test_`, a cobrança com `cardTokenId` é simulada e não movimenta dinheiro. O cadastro do cartão é real, mas não cobra nada. Lembre que o mesmo `cardTokenId` gera cobrança real com a chave de produção.

## Como testar

Execute o cenário **SUB-02** da seção "Cartão salvo e assinaturas" do [roteiro de homologação](https://docs.fastpaybrasil.com/homologacao/roteiro.md): cobrança com `cardTokenId` e `cvv` usando a chave de teste, com status `paid`, comprovando que o CVV é coletado a cada cobrança. O registro do cartão (**SUB-01**) está em [Cofre de cartões](https://docs.fastpaybrasil.com/guias/cofre-de-cartoes.md).

## Veja também

> [card] [Cofre de cartões](https://docs.fastpaybrasil.com/guias/cofre-de-cartoes.md)
>
> Registrar, consultar, listar e excluir cartões.

> [card] [Assinaturas](https://docs.fastpaybrasil.com/guias/assinaturas/visao-geral.md)
>
> Cobrança recorrente sem o cliente presente.

> [card] [Criar cobrança](https://docs.fastpaybrasil.com/referencia/cobrancas/criar.md)
>
> Referência de `POST /v1/charges`.

> [card] [Cartão de crédito](https://docs.fastpaybrasil.com/guias/cobrancas/cartao-de-credito.md)
>
> Cobrança com cartão digitado.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.