PayZu GatewayClientes e cartões

Consultar cartões salvos


Nesta páginaListe os cartõesConsulte um cartãoLeia o último usoErros desta operação

A lista traz os cartões guardados no cliente, com a bandeira, o final e a validade de cada um.

Liste os cartões

bash
curl https://api.sandbox.payzu.dev/v1/customers/cus_bdQT0ls1QMIXVuhngvhbwC/cards \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

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

bash
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_atQuando
nullAinda 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ódigoHTTPMensagem
-404Cliente não encontrado para o id informado.
-404Cartão não encontrado para o id informado.

Os erros de autenticação e de validação estão no Catálogo de erros.