Consultar cartões salvos
A lista traz os cartões guardados no cliente, com a bandeira, o final e a validade de cada um.
Liste os cartões
curl https://api.sandbox.payzu.dev/v1/customers/cus_bdQT0ls1QMIXVuhngvhbwC/cards \
-H "Authorization: Bearer SUA_CHAVE_DE_API"{
"items": [
{
"id": "card_GL2pIWf5pznF4qwg2KKd5v",
"brand": "visa",
"last_digits": "1111",
"expiration": "12/2030",
"holder_name": "MARIA SOUZA",
"last_used_at": "2026-11-11T15:20:59.338Z",
"created_at": "2026-11-11T15:20:59.332Z",
"updated_at": "2026-11-11T15:20:59.332Z"
}
],
"next_cursor": null
}Referência: Listar os cartões salvos de um cliente
A lista filtra pelo dia de criação, com created_from e created_to em AAAA-MM-DD, no fuso de São Paulo, e aceita limit de 1 a 100 cartões por página. Parâmetro que a lista não tem é ignorado. A próxima página vem pelo next_cursor, sem total. Veja Paginação.
A lista traz só os cartões salvos.
Entram os cartões guardados em Salvar um cartão ou com save_card: true ao criar ou pagar uma fatura no cartão. O cartão que só passou por uma cobrança ou por uma assinatura não fica guardado e não aparece aqui.
Consulte um cartão
curl https://api.sandbox.payzu.dev/v1/customers/cus_bdQT0ls1QMIXVuhngvhbwC/cards/card_GL2pIWf5pznF4qwg2KKd5v \
-H "Authorization: Bearer SUA_CHAVE_DE_API"Referência: Consultar um cartão salvo
A resposta traz o cartão no mesmo formato de cada item da lista.
Leia o último uso
last_used_at | Quando |
|---|---|
null | Ainda não houve cobrança com o cartão. |
| Data e hora | Última cobrança com o cartão, aprovada ou não, como o pagamento de uma fatura ou a adesão de uma assinatura criada com credit_card.card_id. |
As renovações automáticas da assinatura não mudam o campo. O número e o CVV nunca voltam nas respostas.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
| - | 404 | Cliente não encontrado para o id informado. |
| - | 404 | Cartão não encontrado para o id informado. |
Os erros de autenticação e de validação estão no Catálogo de erros.