Atualizar cliente

PUT /api/v1/clientes/{id}

Atualiza apenas os campos enviados de um cliente pertencente ao produtor autenticado.

PUT Requisição

bash

curl -X PUT "https://ev.paylog.cash/api/v1/clientes/{id}" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "cpf": "string",
    "nome": "string",
    "email": "[email protected]",
    "telefone": "string",
    "cep": "string",
    "endereco": "string",
    "numero": "string",
    "bairro": "string",
    "cidade": "string",
    "estado": "string",
    "pais": "string",
    "data_nascimento": "string",
    "sexo": "string",
    "complemento": "string",
    "celular": "string",
    "referencia_externa": "string",
    "inscricao_estadual": "string"
  }'

php

use Illuminate\Support\Facades\Http;

$response = Http::withToken('YOUR_TOKEN')
    ->acceptJson()
    ->put('https://ev.paylog.cash/api/v1/clientes/{id}', [
    'cpf' => 'string',
    'nome' => 'string',
    'email' => '[email protected]',
    'telefone' => 'string',
    'cep' => 'string',
    'endereco' => 'string',
    'numero' => 'string',
    'bairro' => 'string',
    'cidade' => 'string',
    'estado' => 'string',
    'pais' => 'string',
    'data_nascimento' => 'string',
    'sexo' => 'string',
    'complemento' => 'string',
    'celular' => 'string',
    'referencia_externa' => 'string',
    'inscricao_estadual' => 'string'
  ]);

javascript

const response = await fetch("https://ev.paylog.cash/api/v1/clientes/{id}", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "cpf": "string",
    "nome": "string",
    "email": "[email protected]",
    "telefone": "string",
    "cep": "string",
    "endereco": "string",
    "numero": "string",
    "bairro": "string",
    "cidade": "string",
    "estado": "string",
    "pais": "string",
    "data_nascimento": "string",
    "sexo": "string",
    "complemento": "string",
    "celular": "string",
    "referencia_externa": "string",
    "inscricao_estadual": "string"
  }),
});

python

import requests

response = requests.put(
    "https://ev.paylog.cash/api/v1/clientes/{id}",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    json={
    "cpf": "string",
    "nome": "string",
    "email": "[email protected]",
    "telefone": "string",
    "cep": "string",
    "endereco": "string",
    "numero": "string",
    "bairro": "string",
    "cidade": "string",
    "estado": "string",
    "pais": "string",
    "data_nascimento": "string",
    "sexo": "string",
    "complemento": "string",
    "celular": "string",
    "referencia_externa": "string",
    "inscricao_estadual": "string"
  },
)

ruby

require "net/http"
require "json"
require "uri"

uri = URI("https://ev.paylog.cash/api/v1/clientes/{id}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Put.new(uri)
request["Authorization"] = "Bearer YOUR_TOKEN"
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = {
  "cpf" => "string",
  "nome" => "string",
  "email" => "[email protected]",
  "telefone" => "string",
  "cep" => "string",
  "endereco" => "string",
  "numero" => "string",
  "bairro" => "string",
  "cidade" => "string",
  "estado" => "string",
  "pais" => "string",
  "data_nascimento" => "string",
  "sexo" => "string",
  "complemento" => "string",
  "celular" => "string",
  "referencia_externa" => "string",
  "inscricao_estadual" => "string"
}.to_json

response = http.request(request)

200 Resposta

json

{
  "code": 0,
  "cliente": {
    "id": 0,
    "sexo": "string",
    "cpf": "string",
    "nome": "string",
    "data_nascimento": "string",
    "inscricao_estadual": "string",
    "email": "[email protected]",
    "endereco": "string",
    "numero": "string",
    "complemento": "string",
    "bairro": "string",
    "cidade": "string",
    "estado": "string",
    "pais": "string",
    "cep": "string",
    "telefone": "string",
    "celular": "string",
    "referencia_externa": "string",
    "created_at": "string",
    "updated_at": "string",
    "code": "string",
    "ml_buyer_id": "string",
    "platform_customer_id": "string",
    "plataforma_origem": 0,
    "email_valido": 0,
    "cart_abandoned": true,
    "cart_abandoned_at": "string",
    "merged_into_id": 0,
    "merged_at": "string"
  }
}

Corpo da requisição

application/json

object

Todos os campos são opcionais; campos enviados devem ser válidos e não vazios.

cpf string

Opcional. CPF/CNPJ válido.
nome string

Opcional. Nome completo ou razão social.
email string email

Opcional. E-mail válido.
telefone string

Opcional. Telefone principal.
cep string

Opcional. CEP.
endereco string

Opcional. Logradouro.
numero string

Opcional. Número.
bairro string

Opcional. Bairro.
cidade string

Opcional. Cidade.
estado string

Opcional. UF ou estado.
pais string

Opcional. País.
data_nascimento string

Opcional. Use DD/MM/AAAA.
sexo string

Opcional. Sexo informado.
complemento string

Opcional. Complemento.
celular string

Opcional. Celular.
referencia_externa string

Opcional. ID externo.
inscricao_estadual string

Opcional. Inscrição estadual.

Respostas

200

Cliente atualizado.

application/json

object

code integer Obrigatório
cliente object Obrigatório
Cliente devolvido por GET /api/v1/clientes (dentro de data[]) e por GET /api/v1/clientes/{id} (dentro de cliente). Todas as chaves estão sempre presentes, mas quase todas as colunas são anuláveis no banco e podem vir null em cadastros históricos. As datas NÃO usam o mesmo formato nos dois endpoints — veja a descrição de created_at.
- id integer Obrigatório
  
  ID interno do cliente.
- sexo string aceita nulo
  
  Sexo informado pelo produtor.
- cpf string aceita nulo Obrigatório
  
  CPF ou CNPJ armazenado para o cliente.
- nome string aceita nulo Obrigatório
  
  Nome completo ou razão social.
- data_nascimento string aceita nulo
  
  Data de nascimento. Na listagem vem como YYYY-MM-DD; na consulta individual e no PUT vem serializada pelo modelo em ISO 8601 (1990-05-18T00:00:00.000000Z).
- inscricao_estadual string aceita nulo
  
  Inscrição estadual quando aplicável.
- email string email aceita nulo Obrigatório
  
  E-mail do cliente.
- endereco string aceita nulo Obrigatório
  
  Logradouro.
- numero string aceita nulo Obrigatório
  
  Número do endereço.
- complemento string aceita nulo
  
  Complemento opcional.
- bairro string aceita nulo Obrigatório
  
  Bairro.
- cidade string aceita nulo Obrigatório
  
  Cidade.
- estado string aceita nulo Obrigatório
  
  UF ou estado informado.
- pais string aceita nulo Obrigatório
  
  País.
- cep string aceita nulo Obrigatório
  
  CEP do endereço.
- telefone string aceita nulo Obrigatório
  
  Telefone principal.
- celular string aceita nulo
  
  Celular opcional.
- referencia_externa string aceita nulo
  
  Identificador opcional no sistema do produtor.
- created_at string aceita nulo Obrigatório
  
  Criação. A listagem lê direto do banco e devolve YYYY-MM-DD HH:mm:ss (2026-07-22 12:20:00); a consulta individual e o PUT devolvem ISO 8601 (2026-07-22T12:20:00.000000Z). Aceite os dois formatos.
- updated_at string aceita nulo Obrigatório
  
  Última atualização. Mesma divergência de formato descrita em created_at.
- code string
  
  Identificador público ULID do cliente, prefixado com CUST.
- ml_buyer_id string aceita nulo
  
  Identificador de comprador do Mercado Livre. Somente leitura.
- platform_customer_id string aceita nulo
  
  Identificador recebido da plataforma de origem. Somente leitura.
- plataforma_origem integer aceita nulo
  
  Código interno da plataforma de origem. Somente leitura.
- email_valido integer
  
  Indicador legado de validação do e-mail (0 ou 1). Somente leitura.
- cart_abandoned boolean
  
  Indica associação a carrinho abandonado. Somente leitura.
- cart_abandoned_at string aceita nulo
  
  Data do carrinho abandonado em ISO 8601. Somente leitura.
- merged_into_id integer aceita nulo
  
  Cliente que absorveu este cadastro numa unificação. Somente leitura.
- merged_at string aceita nulo
  
  Data da unificação em ISO 8601. Somente leitura.

400

Requisição inválida.

application/json

object

code integer

Código legado do erro, normalmente 400.
message string Obrigatório

Resumo do erro de validação.
erros object

Erros por campo retornados pelos endpoints legados.
errors object

Erros por campo retornados por validadores no formato atual.

401

Token ausente/inválido, cliente não pertencente ao produtor, ou cliente unificado (absorvido por um duplicado — invisível para esta rota).

application/json

object

Mensagem de erro ou informação. Alguns erros legados omitem code.

code integer

Código numérico quando fornecido pelo endpoint.
message string

Mensagem legível.

403

O token é válido, mas a conta não possui a permissão necessária para esta operação. O envelope é gerado pelo tratador global de exceções e usa a chave errors (string), não message.

application/json

object

Envelope produzido pelo tratador global de exceções para falhas HTTP que não são geradas pelos controladores — principalmente 403 (permissão ausente) e 405 (verbo não suportado). Difere dos erros dos controladores por usar errors no lugar de message.

errors string Obrigatório

Mensagem da exceção HTTP.
code integer Obrigatório

Código HTTP repetido no corpo.

500

Falha interna durante o processamento.

application/json

object

Mensagem de erro ou informação. Alguns erros legados omitem code.

code integer

Código numérico quando fornecido pelo endpoint.
message string

Mensagem legível.