> ## 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.

# Excluir um cartão

> Remove um cartão salvo e revoga o token no cofre da Finvia.

Esta rota exclui um cartão salvo. O token é revogado no cofre da Finvia e **não pode mais ser usado** em cobranças nem em assinaturas. Depois da exclusão, o cartão aparece com `status` `revoked` em [Listar cartões](https://docs.fastpaybrasil.com/referencia/cartoes/listar.md) quando a listagem é feita sem o filtro `customerId`; com o filtro, ele deixa de aparecer. Use quando o cliente remove o cartão da conta dele no seu site ou quando o cartão deixa de ser válido para o seu negócio.

## Quando usar

| Situação | Como usar esta rota |
| - | - |
| Cliente clicou em "remover cartão" na área logada | Exclua pelo `id` do cartão |
| Cliente encerrou o cadastro no seu serviço | Exclua os cartões dele (encontre-os em [Listar cartões](https://docs.fastpaybrasil.com/referencia/cartoes/listar.md)) e depois o [cliente](https://docs.fastpaybrasil.com/referencia/clientes/excluir.md) |
| Troca de cartão de um assinante | Registre o novo cartão, cancele a assinatura e crie outra. Exclua o cartão antigo só depois que a nova assinatura estiver ativa |

## Antes de chamar

* Tenha uma chave secreta (`sk_`) da conta que registrou o cartão ([Credenciais e ambientes](https://docs.fastpaybrasil.com/primeiros-passos/credenciais-e-ambientes.md)).
* Tenha o `id` do cartão.
* Verifique se o cartão está em uso em alguma assinatura ativa.

> [!WARNING]
>
> A exclusão revoga o token: o cartão deixa de poder ser usado em cobranças **e em assinaturas**. Se ele estiver vinculado a uma assinatura ativa, as próximas renovações não poderão usá-lo. Para trocar o cartão de uma assinatura, crie a nova assinatura com o novo cartão antes de excluir o antigo.

## Parâmetros de caminho

**id** `string` *required*

Identificador único do cartão. Ex.: `2RhQg9M7ZCg3X3nMb9W1kX8Q`.

Esta rota não tem corpo de requisição.

## Respostas

**id** `string`

ID do cartão excluído. Ex.: `2RhQg9M7ZCg3X3nMb9W1kX8Q`.

**deleted** `boolean`

Confirmação da exclusão. Ex.: `true`.

**message** `string`

Mensagem de retorno. Ex.: `Card deleted successfully`.

| HTTP | Significado | Corpo |
| - | - | - |
| `200` | Cartão excluído | `id`, `deleted`, `message` |
| `401` | Credencial inválida | `{"statusCode": 401, "message": "Unauthorized"}` |
| `404` | Cartão não encontrado | `{"statusCode": 404, "message": "Card not found"}` |

> [!NOTE]
>
> **Para o negócio:** oferecer ao cliente a opção de remover o cartão salvo dá a ele controle sobre os próprios dados de pagamento. A remoção é definitiva para aquele token: se o cliente quiser usar o mesmo cartão de novo, ele precisa ser registrado outra vez.

## Erros comuns

| Sintoma | Causa | Como resolver |
| - | - | - |
| `404` com `Card not found` | `id` incorreto ou cartão registrado por outra conta | Confira o `id` e use a chave da conta que registrou o cartão |
| Renovação de assinatura falha depois da exclusão | O cartão excluído era o cartão da assinatura | Crie uma nova assinatura com outro cartão registrado |
| Cobrança com `cardTokenId` falha depois da exclusão | Token revogado | Registre o cartão de novo em [Registrar cartão](https://docs.fastpaybrasil.com/referencia/cartoes/registrar.md) |
| `401 Unauthorized` | Chave ausente, inválida ou mal codificada | Codifique em Base64 a chave seguida de `:` |

```http REST (JSON) theme={null}
DELETE /v1/cards/2RhQg9M7ZCg3X3nMb9W1kX8Q HTTP/1.1
Host: api-global.fastpaybrasil.com
Authorization: Basic <base64 de "SUA_CHAVE_SECRETA:">
```

```bash cURL theme={null}
curl -X DELETE "https://api-global.fastpaybrasil.com/v1/cards/2RhQg9M7ZCg3X3nMb9W1kX8Q" \
  -u "$FINVIA_API_KEY:"
```

```javascript Node.js theme={null}
const credentials = Buffer.from(`${process.env.FINVIA_API_KEY}:`).toString('base64');

const response = await fetch(
  'https://api-global.fastpaybrasil.com/v1/cards/2RhQg9M7ZCg3X3nMb9W1kX8Q',
  { method: 'DELETE', headers: { Authorization: `Basic ${credentials}` } },
);

const result = await response.json();
if (result.deleted) {
  // remova o cartão da tela "meus cartões"
}
```

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

import requests

response = requests.request(
    "DELETE",
    "https://api-global.fastpaybrasil.com/v1/cards/2RhQg9M7ZCg3X3nMb9W1kX8Q",
    auth=(os.environ["FINVIA_API_KEY"], ""),
    timeout=30,
)

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

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

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

curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD => getenv('FINVIA_API_KEY') . ':',
]);

$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());

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api-global.fastpaybrasil.com/v1/cards/2RhQg9M7ZCg3X3nMb9W1kX8Q"))
            .header("Authorization", "Basic " + credentials)
            .method("DELETE", HttpRequest.BodyPublishers.noBody())
            .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 request = new HttpRequestMessage(HttpMethod.Delete, "https://api-global.fastpaybrasil.com/v1/cards/2RhQg9M7ZCg3X3nMb9W1kX8Q");

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"
)

func main() {
	req, err := http.NewRequest("DELETE", "https://api-global.fastpaybrasil.com/v1/cards/2RhQg9M7ZCg3X3nMb9W1kX8Q", nil)
	if err != nil {
		panic(err)
	}
	req.SetBasicAuth(os.Getenv("FINVIA_API_KEY"), "")

	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 "net/http"
require "uri"

uri = URI("https://api-global.fastpaybrasil.com/v1/cards/2RhQg9M7ZCg3X3nMb9W1kX8Q")
request = Net::HTTP::Delete.new(uri)
request.basic_auth(ENV.fetch("FINVIA_API_KEY"), "")

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

puts response.code
puts response.body
```

```json 200 theme={null}
{
  "id": "2RhQg9M7ZCg3X3nMb9W1kX8Q",
  "deleted": true,
  "message": "Card deleted successfully"
}
```

```json 404 theme={null}
{
  "statusCode": 404,
  "message": "Card not found"
}
```

## Veja também

> [card] [Cofre de cartões](https://docs.fastpaybrasil.com/guias/cofre-de-cartoes.md)
>
> Ciclo de vida do cartão salvo.

> [card] [Ciclo de vida da assinatura](https://docs.fastpaybrasil.com/guias/assinaturas/ciclo-de-vida.md)
>
> Cancelar e recriar assinatura para trocar o cartão.

> [card] [Cobrança com cartão salvo](https://docs.fastpaybrasil.com/guias/cobrancas/cartao-salvo.md)
>
> Uso do `cardTokenId` em recompras.

> [card] [Registrar cartão](https://docs.fastpaybrasil.com/referencia/cartoes/registrar.md)
>
> Guardar um novo cartão.


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