> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abacatepay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Referência

> Clientes para pré-preencher checkout e reutilizar em várias cobranças

Use `/customers/create` para cadastrar um cliente antes de cobrar. O `customerId` retornado pode ser usado em várias cobranças e pré-preenche o checkout.

<Card title="Campos obrigatórios" horizontal>
  Só `email` é obrigatório. Recomendado: `name`, `cellphone` e `taxId` quando tiver.
</Card>

**Exemplo:**

```json theme={null}
POST /customers/create
{
  "data": {
    "email": "customer@example.com",        // obrigatório
    "taxId": "12345678900",                 // opcional
    "name": "João Silva",                   // opcional
    "cellphone": "+5511999999999",          // opcional
    "zipCode": "01310-100"                  // opcional
  },
  "metadata": {                             // opcional - dados extras da sua aplicação
    "customField": "value"
  }
}
```

**Resposta:**

```json theme={null}
{
  "data": {
    "id": "cust_abc123xyz",
    "devMode": false,
    "email": "customer@example.com",
    "taxId": "12345678900",
    "country": "BR",
    "name": "João Silva",
    "cellphone": "+5511999999999",
    "zipCode": "01310-100",
    "metadata": {
      "customField": "value"
    }
  },
  "success": true,
  "error": null
}
```

<Tip title="CPF/CNPJ único" icon="book" horizontal>
  Cliente é único por CPF/CNPJ. Se já existir, a API devolve o existente em vez de criar outro. CPF/CNPJ inválido não é aceito.
</Tip>