Clientes
Gerencie os dados do cliente e consulte faturas, assinaturas e formas de pagamento.
Um cliente reúne a atividade comercial de uma pessoa ou empresa dentro da sua conta ativa. Criar um cliente não inicia um pagamento nem uma assinatura.
Criar ou atualizar um cliente
Você precisa de acesso para gerenciar clientes. Confirme a conta ativa antes de salvar.
- Abra Cobranças → Clientes e selecione Criar cliente.
- Informe um email válido e um nome opcional.
- Escolha o idioma preferido do cliente: inglês, espanhol ou português.
- Ative a seção opcional de endereço se necessário. Preencha país, rua, cidade, CEP e estado quando obrigatório.
- Salve e abra o detalhe do cliente para conferir o resultado.
Use Editar para atualizar dados de contato, idioma ou endereço de um cliente existente. O idioma preferido é utilizado nas comunicações compatíveis para clientes; é independente do idioma do seu perfil ou da documentação.
Consultar o histórico comercial
Abra um cliente para consultar informações de faturamento, formas de pagamento salvas, faturas e assinaturas. Siga o link da fatura ou assinatura para conferir valor, estado e ações disponíveis.
Uma forma de pagamento salva não comprova o sucesso de um pagamento. Confira os valores pagos e pendentes da fatura e seu histórico de pagamentos. Alterar os dados do cliente não modifica o documento salvo de uma fatura anterior.
Oferecer acesso ao portal
No detalhe do cliente:
- Abrir link do portal abre um link de acesso temporário sem enviar email ao cliente.
- Enviar link do portal solicita o envio de um link ao email do cliente.
Links de acesso são sensíveis. Use a ação de envio para convidar um cliente e não publique um link de acesso pessoal. Consulte Portal do cliente para conhecer a página de acesso da conta e recuperar links expirados.
Usar clientes pela API
A API de Customers permite criar, listar, consultar, atualizar e arquivar perfis pelo backend. O email é obrigatório e único dentro da conta e do ambiente ativos. metadata aceita pares de chave e valor em texto; um patch combina os novos valores e remove uma chave quando seu valor é null.
Atualizações e arquivamento exigem o ETag atual em If-Match e um Idempotency-Key único. Arquivar é uma exclusão lógica: o histórico permanece disponível, mas o perfil não pode ser associado a novas compras. O Pharos rejeita o arquivamento enquanto houver checkouts ou obrigações de cobrança em aberto.
Consulte a API de Customers para ver os esquemas completos.
Problemas frequentes
- Cliente não aparece: confira conta, ambiente, busca e filtros ativos.
- Endereço não é salvo: preencha os campos obrigatórios para o país escolhido.
- Não há formas de pagamento ou faturas: o cliente pode ainda não ter essa atividade; criar um contato não gera histórico comercial.
- Portal não abriu: permita que o navegador abra uma nova aba e tente novamente.
- Email não chegou: confira o endereço e o estado de entrega quando disponível; solicitar o envio não comprova recebimento nem leitura.