> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.gomoney.me/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.gomoney.me/_mcp/server.

# Customers

## Objetivo do módulo

O módulo de customers permite associar cobranças e operações a clientes específicos do integrador.

Cada customer é vinculado ao usuário autenticado e recebe automaticamente uma wallet própria no momento da criação.

## Papel operacional do cadastro

O cadastro de customers existe para dar contexto de negócio às cobranças e às rotinas de conciliação. Em vez de operar apenas com valores e identificadores transacionais, a integração passa a refletir a relação entre uma cobrança e o cliente final a que ela pertence.

## Fluxo recomendado

1. autentique o usuário que administra a integração;
2. registre os customers relevantes para a operação;
3. mantenha os dados atualizados conforme a evolução do relacionamento comercial;
4. utilize a referência correta do customer na geração das cobranças.

## Campos principais

* identificação documental do customer;
* nome e dados básicos de contato;
* parâmetros operacionais que podem influenciar regras de cobrança;
* vínculo automático com uma wallet própria gerada para o cadastro.

## Cuidados de implementação

* trate o cadastro do customer como a referência principal da sua conciliação;
* valide e-mail e documento antes de iniciar a operação;
* não assuma que todas as configurações complementares estarão sempre preenchidas;
* faça a desativação do customer apenas quando ele realmente sair de operação no seu fluxo.

## Onde ver os detalhes técnicos

Os métodos disponíveis, requisitos de autenticação, exemplos de envio e respostas ficam concentrados na área [API Reference](./api-reference-overview).