Pular para o conteúdo principal
PATCH
Atualizar um cliente

Autorizações

Authorization
string
header
obrigatório

Chave de API sk_vl_... criada no painel em Desenvolvedores → Chaves de API.

Parâmetros de caminho

customer_id
string
obrigatório

Id do cliente.

Pattern: ^cus_[A-Za-z0-9_-]{16}$

Corpo

application/json
name
string

Nome.

Maximum string length: 120
email
string<email> | null

E-mail.

document
string | null

CPF ou CNPJ, só dígitos.

Pattern: ^(\d{11}|\d{14})$
phone
string | null

Telefone, só dígitos.

Pattern: ^\+?\d{8,15}$
external_reference
string | null

O seu identificador.

Maximum string length: 100
metadata
object

Até 20 pares chave/valor em texto (chave até 40, valor até 500 caracteres). Volta igual nas respostas e nos webhooks.

Exemplo:

Resposta

Cliente atualizado.

id
string

Id do cliente.

Pattern: ^cus_[A-Za-z0-9_-]{16}$
Exemplo:

"cus_Xk2v9QeR7tLmN3bA"

object
enum<string>

Sempre customer.

Opções disponíveis:
customer
name
string

Nome.

email
string | null

E-mail.

document
string | null

CPF ou CNPJ, só dígitos.

phone
string | null

Telefone, só dígitos.

external_reference
string | null

O seu identificador.

metadata
object

Até 20 pares chave/valor em texto (chave até 40, valor até 500 caracteres). Volta igual nas respostas e nos webhooks.

Exemplo:
created_at
string<date-time>

Criação.

updated_at
string<date-time>

Última alteração.