customer representa a pessoa física ou jurídica que compra de você. Ele
reúne identidade e dados de cobrança — nome, e-mail, telefone, CPF/CNPJ, nome
de cobrança e endereço. O identificador do cadastro é o id; o e-mail é
obrigatório, mas pode aparecer em mais de um customer da mesma organização.
É a ele que se prendem pagamentos, assinaturas, invoices e métodos de pagamento
salvos. Na API, cada criação gera um customer novo, exceto quando o documento
informado já pertence a outro cadastro ativo. No checkout hospedado, a Chargefy
mantém o customer fixado na sessão ou resolve um cadastro existente por
CPF/CNPJ e, depois, por e-mail antes de criar outro.
Data Object
Este é o formato completo retornado emcreate, get, update, itens de
list e em data.object dos webhooks customer.*.
Telefone do cliente no formato internacional, com
+ e código do país (ex.:
+5511999990000). Vem null quando não foi informado.Nome fantasia do cliente — o nome pelo qual você o identifica no dia a dia.
Em cliente pessoa jurídica é o nome fantasia da empresa; em pessoa física, o
apelido ou nome curto. É um campo de exibição: não aparece em invoice, recibo
nem em qualquer documento fiscal — para isso existe
billing_name. Vem
null quando não foi informado.Data da última atualização em ISO 8601. Vem
null enquanto o customer nunca
foi atualizado.Operações
Eventos
Mudanças nesse objeto disparam os seguintes eventos: O payload sempre carrega o objetocustomer completo em data.object; eventos de update também incluem data.previous_attributes com os valores anteriores dos campos alterados.
