Skip to main content
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.

Campos obrigatórios

Só email é obrigatório. Recomendado: name, cellphone e taxId quando tiver.
Exemplo: 
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: 
{
  "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
}
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.