Cadastro de clientes

​

Por que cadastrar um cliente

• Checkout mais curto. Crie o checkout com o customerId. Se o cadastro tem nome, e-mail e CPF/CNPJ, o checkout pula a etapa de dados pessoais e cobra esse cliente. Com cadastro incompleto, o cliente preenche os dados no checkout.
• Endereço já resolvido. Numa assinatura com Pix, um cadastro completo com endereço completo também pula a etapa de endereço.
• Histórico por cliente. No dashboard, cada cliente mostra as cobranças e as assinaturas dele.
• Portal do cliente. O link do Portal do cliente é gerado para um cliente e um checkout.

​

Campos do cadastro

​

Como a AbacatePay evita clientes duplicados

• A busca segue esta ordem: CPF/CNPJ, depois e-mail, depois celular. Clientes excluídos ficam de fora. Se houver mais de um, vale o mais antigo.
• Pelo e-mail ou pelo celular, a busca só aproveita um cadastro sem CPF/CNPJ ou com o mesmo CPF/CNPJ que você enviou. Um cliente com outro CPF/CNPJ nunca é reaproveitado.
• Quando acha, a API devolve o cliente existente, com o mesmo id, e atualiza nome, e-mail, celular, CPF/CNPJ, CEP e endereço com o que você enviou. Os campos que você não enviou ficam como estavam.
• O metadata do cliente existente não muda.

​

Pelo dashboard

​

Pela API

curl -X POST https://api.abacatepay.com/v2/customers/create \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  --data '{
    "email": "joao@exemplo.com",
    "name": "João Silva",
    "taxId": "111.444.777-35",
    "cellphone": "(11) 99999-9999"
  }'

{
  "data": {
    "id": "cust_abc123xyz",
    "devMode": true,
    "email": "joao@exemplo.com",
    "taxId": "11144477735",
    "country": null,
    "name": "João Silva",
    "cellphone": "11999999999",
    "zipCode": null,
    "address": null,
    "metadata": {}
  },
  "success": true,
  "error": null
}

{
  "customerId": "cust_abc123xyz",
  "items": [{ "id": "prod_abc123xyz", "quantity": 1 }]
}

​

Testar no Modo Teste

​

Perguntas frequentes