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
| Campo | Regra |
|---|---|
expiration | MM/AAAA, sem estar vencida. |
holder_name | De 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ódigo | HTTP | Mensagem |
|---|---|---|
| - | 404 | Cliente não encontrado para o id informado. |
| - | 404 | Cartão não encontrado para o id informado. |
PZ202 | 503 | Nã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.