> 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.

# Primeiros Passos

## Pré-requisitos

Antes de consumir a API, confirme:

* conta ativa na plataforma;
* acesso criado na plataforma com tipo `INTEGRATION`;
* permissão `INTEGRATION_ONLY` ativa nesse acesso;
* acesso ao painel para solicitar as chaves;
* wallet operacional cadastrada no perfil;
* wallet operacional aprovada pela plataforma;
* origem do seu sistema definida para chamadas de pagamento.

## Sequência recomendada

### 1. Acesso inicial

O primeiro passo é garantir que o usuário responsável pela integração consiga acessar a plataforma e criar um acesso específico para API, do tipo `INTEGRATION`, com `INTEGRATION_ONLY` ativo.

### 2. Solicitação das chaves

Envie ao suporte:

* identificação do usuário integrador e do acesso de integração;
* domínio ou origem operacional;
* wallet operacional já cadastrada e aprovada;
* necessidade de uso dos fluxos de pagamento.

### 3. Recebimento das credenciais

As credenciais são enviadas exclusivamente por e-mail. A partir desse momento, o integrador passa a ter responsabilidade direta sobre o armazenamento e o uso seguro desses dados.

### 4. Habilitação da integração

Com as credenciais recebidas, o acesso de integração passa a operar dentro das regras liberadas para aquele usuário, incluindo domínio autorizado e validações de vínculo com a wallet operacional.

### 5. Cadastro de customers

Cadastre os customers antes de gerar cobranças que dependem de conciliação por cliente.

### 6. Geração de cobranças

As cobranças PIX devem ser emitidas já vinculadas ao customer adequado, para preservar rastreabilidade e permitir o tratamento correto do fluxo operacional após o pagamento.

## O que precisa estar definido antes do go-live

* responsáveis técnicos pelo ambiente;
* canais de suporte;
* wallet operacional vinculada;
* política de armazenamento seguro de credenciais;
* estratégia de conciliação por customer;
* rotina de resposta a falhas de autenticação e indisponibilidade transitória.