Criar cliente
Clientes
Criar Cliente
Cadastra um cliente para reutilizar em cobranças futuras.
Apenas email é obrigatório; demais campos são opcionais mas
recomendados para facilitar identificação e cobrança via PIX.
taxId (CPF ou CNPJ) é validado contra duplicatas no mesmo merchant.
POST
Criar cliente
Cadastra um novo cliente vinculado ao seu merchant.
Exemplo:
Obrigatório
Apenas
email é obrigatório. Inclua name, taxId e phone sempre
que tiver — facilita relatórios e melhora a experiência no PIX.taxId é único por merchant. Se já existir um customer com o mesmo
taxId, a API responde 409 CONFLICT em vez de criar duplicidade.Authorizations
Autentique suas requisições enviando o token no header
Authorization: Bearer <token>.
O token pode ser:
- Uma API key com prefixo
liq_, gerada em Dashboard Liquerapay → Configurações → API Keys. - Um JWT retornado pelo login do dashboard (uso interno).
Não há distinção de ambiente — toda chave vale para o único ambiente disponível (produção).
Body
application/json
Example:
"joao@exemplo.com"
Required string length:
1 - 120Example:
"João Silva"
CPF (11 dígitos) ou CNPJ (14 dígitos) — apenas números aceitos na validação, mas você pode enviar formatado.
Example:
"12345678900"
Maximum string length:
20Example:
"+5511999999999"