Criar um cliente

POST /v1/customers · Requer o escopo customers:write

Cria um cliente na sua conta. Vincule um a um checkout via customer_id para não reenviar os dados do comprador a cada vez.

Parâmetros do corpo

string

obrigatório

Nome completo do cliente ou razão social. De 1 a 160 caracteres.

string

obrigatório

E-mail válido, até 320 caracteres. Armazenado em minúsculas. Deve ser único na sua conta.

string

Telefone, de 1 a 32 caracteres. Recomenda-se o formato E.164 (+5511999999999).

string

CPF ou CNPJ, de 1 a 32 caracteres. Enviado como veio — só dígitos ou formatado.

object

Pares chave–valor livres para seu uso. Retornados em toda representação do cliente.

Campos desconhecidos causam 400 (invalid_request).

Requisição

cURL

curl --request POST https://api.moneydev.com.br/v1/customers \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "João da Silva",
    "email": "joao.silva@example.com",
    "phone": "+5511999999999",
    "tax_id": "12345678909",
    "metadata": { "user_id": "usr_789" }
  }'

Resposta

201 Created com o objeto de cliente.

{
  "id": "cus_9b2c4f1a-3d5e-4a7b-8c9d-1e2f3a4b5c6d",
  "object": "customer",
  "name": "João da Silva",
  "email": "joao.silva@example.com",
  "phone": "+5511999999999",
  "tax_id": "12345678909",
  "status": "active",
  "metadata": { "user_id": "usr_789" },
  "created_at": "2026-08-28T13:00:00.000Z",
  "updated_at": "2026-08-28T13:00:00.000Z"
}

Erros

Status	`code`	Causa
`400`	`invalid_request`	Validação falhou; `param` indica o campo
`400`	`invalid_customer_name`	`name` ficou vazio após remover espaços
`409`	`customer_email_already_exists`	Outro cliente da sua conta usa esse e-mail

Objeto de cliente

string

ID do cliente, com prefixo cus_.

string

Sempre "customer".

string

Nome completo ou razão social.

string

E-mail, em minúsculas.

string | null

Telefone, ou null.

string | null

CPF ou CNPJ, ou null.

string

active ou inactive. Novos clientes nascem active.

object

Seus metadados. {} se nada foi definido.

string

Data/hora de criação em ISO 8601.

string

Data/hora da última alteração em ISO 8601.

Introdução

Conta

Clientes

Produtos

Ofertas

Checkouts

Parâmetros do corpo

Requisição

Resposta

Erros

Objeto de cliente

​Parâmetros do corpo

​Requisição

​Resposta

​Erros

​Objeto de cliente

Parâmetros do corpo

Requisição

Resposta

Erros

Objeto de cliente