Atualizar cliente

Atualiza um ou mais campos de um cliente. Apenas os campos enviados são alterados. **O `document` é imutável** — se foi cadastrado errado, delete e crie um novo. Clientes arquivados não podem ser editados — restaure primeiro (não disponível via API ainda, requer dashboard).

PATCH/v2/customers/:id

Autenticação

HTTP Basic Auth. Envie sua secret key no header:

Authorization: Basic {base64(secret:SUA_SECRET_KEY)}

Parâmetros

idstring (path, UUID)obrigatório

UUID do cliente.

Exemplo: c8a5f4d2-1b3e-4c9f-8a7d-2e5f6c1d4b9a

Body da requisição

Content-Type: application/json

JSON

{
  "phone": "11912345678",
  "email": "joao.silva.novo@exemplo.com",
  "birthDate": null,
  "metadata": { "tier": "vip" }
}

Respostas

200

Cliente atualizado. Retorna o objeto completo com os campos novos aplicados. birthDate pode ser passado como null para limpar; outros campos opcionais aceitam string vazia.

JSON

{
  "id": "c8a5f4d2-1b3e-4c9f-8a7d-2e5f6c1d4b9a",
  "name": "João Silva",
  "email": "joao.silva.novo@exemplo.com",
  "document": "12345678901",
  "phone": "11912345678",
  "birthDate": null,
  "metadata": { "tier": "vip" },
  "createdAt": "2026-05-26T14:32:01.923Z",
  "updatedAt": "2026-05-26T15:45:12.501Z"
}

400

Validação falhou OU cliente está arquivado.

JSON

{
  "status": 400,
  "error": "Cliente deletado. Restaure antes de editar."
}

404

Cliente não encontrado nessa conta.

JSON

{ "status": 404, "error": "Cliente nao encontrado" }

Exemplos

cURL

curl -X PATCH "https://api.pagnovo.com/v2/customers/c8a5f4d2-1b3e-4c9f-8a7d-2e5f6c1d4b9a" \
  -H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{ "phone": "11912345678" }'

JavaScript

const token = Buffer.from("secret:" + process.env.PAGNOVO_SECRET_KEY).toString("base64");
 
const res = await fetch(
  `https://api.pagnovo.com/v2/customers/${customerId}`,
  {
    method: "PATCH",
    headers: {
      Authorization: `Basic ${token}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ phone: "11912345678" }),
  },
);
 
const updated = await res.json();
console.log("phone atualizado em:", updated.updatedAt);