Adição de saldos

Adição, consulta e comportamento do fluxo após a adição

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:

Valida os dados recebidos;
Localiza a carteira dos clientes enviados;
Inclui o saldo em GMC;
Transfere o saldo em GMC para a carteira vinculada ao usuário;
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.