# Atualizar Cliente
`PATCH /v1/customers/:customerId`
**Área:** Clientes

**Scopes necessários:** `customers/write`

Atualiza os dados de um cliente. Envie apenas os campos que deseja alterar.

O documento não pode ser alterado: enviar um CPF/CNPJ diferente do atual retorna erro 400 (DOCUMENT_UPDATE_NOT_ALLOWED). Quando o endereço é enviado, ele substitui o endereço padrão do cliente.

Case de uso:

_Como plataforma, quero atualizar o e-mail e o telefone de um cliente que mudou de contato, sem recriar o cadastro._

### Path parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `customerId` | **sim** | Customerid |

### Request body

```json
{
  "name": "Alexandre Souza Silva",
  "email": "novo@exemplo.com.br",
  "additionalEmails": ["financeiro@exemplo.com.br"],
  "phone": "5511987654321",
  "address": {
    "zipCode": "01310100",
    "street": "Avenida Paulista",
    "number": "2000",
    "complement": "Andar 3",
    "neighborhood": "Bela Vista",
    "city": "São Paulo",
    "state": "SP"
  }
}
```

### Campos do body

**Obrigatórios:** `address.zipCode`, `address.street`, `address.number`, `address.neighborhood`, `address.city`, `address.state`

| Campo | Descrição |
|---|---|
| `address.zipCode` |  |
| `address.street` |  |
| `address.number` |  |
| `address.neighborhood` |  |
| `address.city` |  |
| `address.state` |  |

**Opcionais**

| Campo | Descrição |
|---|---|
| `name` |  |
| `email` |  |
| `phone` | E.164 com DDI 55 |
| `address` | substitui o endereço padrão |
| `address.complement` |  |

### Resposta 200 — 200

```json
{
  "customer": {
    "customerId": "cus_xxx",
    "name": "Alexandre Souza Silva",
    "email": "novo@exemplo.com.br",
    "phone": "5511987654321"
  }
}
```

### Resposta 400 — 400

```json
{
    "error": {
        "message": "O documento do cliente não pode ser alterado",
        "code": "DOCUMENT_UPDATE_NOT_ALLOWED",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/patch-atualizar-cliente
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json