Cartões salvos

Para o passo a passo, veja o guia Cartão salvo.

	Rota
`GET`	`/v1/cards/config`	`script`, `publishable_key` e `allowed_origins` dos campos de cartão deste modo
`PATCH`	`/v1/cards/config`	`allowed_origins`: os únicos sites que podem mostrar os campos (lista vazia: qualquer um). Chave completa
`POST`	`/v1/cards`	salvar um cartão a partir do `tok_…` dos campos de cartão
`GET`	`/v1/cards`	listar (`customer_id`, `limit`, `starting_after`)
`GET`	`/v1/cards/{id}`	ver
`DELETE`	`/v1/cards/{id}`	apagar (também do cofre)

Salvar

Campo
`vault_token`	obrigatório	o `tok_…` que `card.tokenize()` devolveu, em até 24 horas
`holder_name`	obrigatório	nome impresso no cartão
`customer` ou `customer_id`		dono do cartão: cliente novo (ou o mesmo CPF/CNPJ) ou um que já existe
`metadata`

Salvar aceita chave restrita de cobranças. Cobrar cartão salvo (card.id em /v1/payments) e apagar pedem chave completa.

Objeto

{
  "id": "card_4Fh...",
  "object": "card",
  "mode": "test",
  "brand": "visa",
  "last4": "1111",
  "exp_month": 12,
  "exp_year": 2030,
  "holder_name": "ANA LIMA",
  "fingerprint": "Xk2...",
  "customer": "cus_...",
  "cvc_available_until": null,
  "metadata": {},
  "created_at": "2026-10-19T17:30:00.000Z"
}

brand: visa, mastercard, elo, hipercard, american-express, diners-club, discover ou jcb. cvc_available_until: até quando o CVV ainda existe (vem null depois da primeira aprovação ou passada 1 hora).

Erros

`code`
`card_expired`	o cartão está vencido
`account_not_enabled`	o cofre não está ligado neste modo, ou nenhuma conta conectada cobra este cartão agora (por exemplo, as que restam pedem o CVV e ele já foi apagado)
`invalid_card`	o cofre recusou o uso do cartão (apagado, ou CVV já apagado)