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

# Adição de saldos

## Autenticação exigida

* Autenticação de sessão da camada de adição de saldos;
* Credencial de integração da conta;
* Validação da origem operacional autorizada.

## Informações essenciais da adição

* Valor a ser debitado;
* Identificação do pagador;
* Moeda de referência.

## Recomendação operacional

Mesmo quando o contrato técnico admite flexibilidade em alguns dados, trate como prática operacional obrigatória:

* A identificação do customer para garantir conciliação correta;
* A definição explícita da moeda para adição do saldo.

## O que acontece após o envio

Depois da confirmação da adição, a plataforma executa o fluxo funcional:

1. Valida os dados recebidos;
2. Localiza a carteira dos clientes enviados;
3. Inclui o saldo em GMC;
4. Transfere o saldo em GMC para a carteira vinculada ao usuário;
5. Registra todas as hash de confirmação das operações.

## Endpoints auxiliares

* Consulta da lista de adições do usuário autenticado;
* Consulta individual de uma adição específica.

## Dados que devem ser persistidos pelo integrador

* Identificador interno da adição;
* Vínculo da cobrança com o customer;
* Referência de correlação do integrador, quando utilizada;
* Status atual e timestamps relevantes.

## Onde ver os detalhes técnicos

Os formatos de envio, os parâmetros aceitos, os exemplos completos e os modelos de resposta ficam concentrados na área [API Reference](./api-reference-overview).