PayZu GatewayClientes e cartões

Apagar um cartão salvo


Tire da lista um cartão que o cliente não usa mais. A resposta é 204, sem corpo.

Apague o cartão

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

Referência: Excluir um cartão salvo

O cartão sai da lista, e consultar, alterar ou apagar de novo responde 404. O id dele também responde 404 nas cobranças. A Idempotency-Key é opcional e segue as regras de Idempotência.

  • Assinatura active: o cartão dela não é apagado. Cancele a assinatura antes, como em Cancelar uma assinatura.
  • Assinatura incomplete ou canceled: o cartão dela é apagado normalmente.

A exclusão do cliente também apaga todos os cartões salvos dele.

Veja Excluir um cliente.

Erros desta operação

CódigoHTTPMensagem
-404Cliente não encontrado para o id informado.
-404Cartão não encontrado para o id informado.
PZ200409O cartão é usado por uma assinatura ativa. Cancele a assinatura antes de excluir.

Os erros de autenticação, de idempotência e de validação estão no Catálogo de erros.