PayZu GatewayClientes e cartões

Alterar um cartão salvo


Corrija a validade ou o nome do titular sem salvar o cartão de novo.

Altere a validade e o nome

bash
curl -X PATCH https://api.sandbox.payzu.dev/v1/customers/cus_bdQT0ls1QMIXVuhngvhbwC/cards/card_GL2pIWf5pznF4qwg2KKd5v \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "expiration": "12/2032",
    "holder_name": "MARIA S SOUZA"
  }'
Trecho da resposta
{
  "id": "card_GL2pIWf5pznF4qwg2KKd5v",
  "expiration": "12/2032",
  "holder_name": "MARIA S SOUZA",
  "updated_at": "2026-11-11T15:44:18.660Z"
}

Referência: Alterar um cartão salvo

CampoRegra
expirationMM/AAAA, sem estar vencida.
holder_nameDe 1 a 64 caracteres.

Envie ao menos um dos dois. A Idempotency-Key é opcional e segue as regras de Idempotência.

O número do cartão não muda.

Para outro cartão, salve um cartão novo.

Erros desta operação

CódigoHTTPMensagem
-404Cliente não encontrado para o id informado.
-404Cartão não encontrado para o id informado.
PZ202503Não foi possível processar o cartão agora. Tente de novo.

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