> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gifty.lat/llms.txt
> Use this file to discover all available pages before exploring further.

# Balance

# Entender o saldo e o resgate parcial

O valor emitido, o que já foi usado e o que ainda pode ser resgatado.

O saldo é o valor emitido menos o valor resgatado. **Esta documentação não conhece o saldo do seu código**: para conferir um caso real, abra o detalhe no gifty com acesso à loja correspondente.

## Um exemplo, passo a passo

O diagrama usa unidades de exemplo, não uma moeda ou um saldo real. Escolha uma etapa ou reproduza a sequência. A tabela abaixo contém as mesmas informações.

[Exemplo: são emitidas 100 unidades, 30 são resgatadas e restam 70; ao usar as outras 70, o saldo chega a 0.](#exemplo-completo)

## Exemplo completo

| Momento                  | Emitido | Total resgatado | Saldo |
| ------------------------ | ------- | --------------- | ----- |
| Emissão                  | 100     | 0               | 100   |
| Primeiro resgate parcial | 100     | 30              | 70    |
| Resgate do restante      | 100     | 100             | 0     |

O valor a descontar deve ser maior que zero e não pode superar o saldo disponível. Ao esgotar o saldo, o vale-presente fica resgatado; se houver saldo após um uso parcial, fica parcialmente resgatado.

## Quando o resgate parcial é permitido

A loja precisa habilitar o resgate parcial e o vale-presente deve ser elegível. A preferência vem desativada por padrão. Ela se aplica a vales-presente nativos do gifty, inclusive os já emitidos que continuem elegíveis; os migrados ficam fora desse fluxo.

Se a preferência for desativada, os vales-presente já usados parcialmente conservam o uso do saldo restante até esgotar ou vencer. Os que não tiveram uso parcial voltam ao comportamento de resgate completo. Ativar a opção não recupera valor que já tenha sido perdido.

## Se o saldo mudar durante a confirmação

Outra compra pode consumir saldo antes da confirmação. Leia o saldo atualizado e ajuste o valor; não repita o valor anterior sem conferir. A confirmação valida o saldo novamente.

## Se um resgate ficar incompleto

O resgate no balcão coordena o cupom da loja e o saldo. Se a operação ficar pendente, use as opções de concluir ou cancelar oferecidas pelo gifty. Cancelar uma tentativa pendente não desfaz um resgate já concluído.

Após um resgate parcial, a atualização do cupom continua de forma durável. **Não suponha que o código possa ser usado novamente de forma instantânea**: acompanhe o estado da operação.

## O que este exemplo não decide

O diagrama não valida códigos, não altera preferências e não realiza resgates. Consulte as condições reais na loja do vale-presente. Ele não pressupõe uso em outra loja.

[Emitir e verificar uma entrega](/pt-BR/issue-and-deliver) · [Ver o ciclo completo](/pt-BR/gift-lifecycle)

[Ler esta página em Markdown](/exports/pt-BR/balance.md)

## Continue explorando

* [Resgatar no balcão](/pt-BR/redemption-at-counter)
* [Configurar resgate parcial e sincronização](/pt-BR/balance-settings-and-sync)
* [O ciclo de um vale-presente](/pt-BR/gift-lifecycle)