PayZu GatewayClientes e cartões

Alterar um cliente


Nesta páginaAltere o clienteRegras de cada campoErros desta operação

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

CampoRegra
phone e birthdateAceitam null para apagar o valor.
addressLeva 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.
metadataSubstitui 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ódigoHTTPMensagem
-400O cliente ainda não tem endereço: envie o endereço completo.
-404Cliente não encontrado para o id informado.
PZ701409O 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.