PayZu GatewayClientes e cartões
Alterar um cliente
Mude os dados de contato, o endereço ou o metadata de um cliente enviando só os campos que mudam.
Altere o cliente
bash
curl -X PATCH https://api.sandbox.payzu.dev/v1/customers/cus_bdQT0ls1QMIXVuhngvhbwC \
-H "Authorization: Bearer SUA_CHAVE_DE_API" \
-H "Content-Type: application/json" \
-d '{
"phone": "11912345678",
"address": { "complement": "Sala 14" }
}'Trecho da resposta
{
"id": "cus_bdQT0ls1QMIXVuhngvhbwC",
"phone": "11912345678",
"updated_at": "2026-11-11T15:20:59.325Z",
"address": {
"street": "Avenida Paulista",
"number": "1000",
"complement": "Sala 14",
"district": "Bela Vista",
"city": "São Paulo",
"state": "SP",
"zip_code": "01310100",
"country": "BR"
}
}Referência: Alterar um cliente
A resposta traz o cliente completo, no formato de Consultar clientes.
O documento não muda.
document e document_type só passam se forem iguais aos gravados.
Regras de cada campo
| Campo | Regra |
|---|---|
phone e birthdate | Aceitam null para apagar o valor. |
address | Leva só os campos que mudam, e o resto do endereço gravado fica. number e complement aceitam null para apagar o valor. Cliente sem endereço precisa do endereço completo. |
metadata | Substitui o mapa inteiro, como explica Metadados. |
Corpo vazio ou com campo desconhecido, na raiz ou em address, responde 400. A Idempotency-Key é opcional e segue as regras de Idempotência.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
| - | 400 | O cliente ainda não tem endereço: envie o endereço completo. |
| - | 404 | Cliente não encontrado para o id informado. |
PZ701 | 409 | O documento do cliente não pode ser alterado. |
Os erros de autenticação, de idempotência e de validação estão no Catálogo de erros.