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

# Gift lifecycle

# O ciclo de um vale-presente

Uma referência para produto, pedido, emissão, entrega e resgate.

[Leia a explicação completa em texto.](#do-produto-ao-resgate)

Um vale-presente passa por processos diferentes. Separá-los ajuda a identificar onde agir e evita confundir pagamento, envio e resgate.

## Do produto ao resgate

| Etapa                    | O que representa                                            | O que não comprova sozinha                               |
| ------------------------ | ----------------------------------------------------------- | -------------------------------------------------------- |
| Produto de vale-presente | A opção publicada no catálogo da loja.                      | Que alguém tenha comprado.                               |
| Pedido pago              | A compra que precisa ser processada.                        | Que todas as unidades estejam configuradas e entregues.  |
| Configuração             | Os dados necessários para cada presente e destinatário.     | Que a emissão terminou.                                  |
| Emissão                  | A criação do vale-presente de uma unidade.                  | Que o destinatário recebeu a mensagem.                   |
| Entrega                  | As tentativas e os resultados do envio desse vale-presente. | Que o destinatário abriu ou resgatou.                    |
| Presente público         | A página que o destinatário abre pelo link.                 | Uma nova compra ou um resgate concluído.                 |
| Resgate                  | O uso do valor e a atualização do saldo.                    | Que o vale-presente se esgotou quando o uso foi parcial. |

A emissão manual começa por uma ação do lojista, sem exigir um pedido do checkout. A documentação distingue essa entrada da compra online.

## Integrações atuais e limites

Tiendanube/Nuvemshop é a plataforma de ecommerce deste percurso. Marketing Nube tem uma área própria de conexão e públicos; consulte essa integração para entender o alcance. Essas conexões não significam que exista uma API pública transacional do gifty.

## API pública: indisponível

**A API pública transacional não está disponível.** Este piloto não documenta endpoint público para emitir, consultar saldos ou resgatar. Não invoque `POST /gift-cards` nem deduza um contrato a partir de rotas internas do app.

Uma futura referência de API deverá definir autenticação, permissões, idempotência, erros, limites e versionamento sobre uma implementação aprovada. Esta página não anuncia data nem contrato dessa API.

## Informações para agentes

As páginas públicas explicam o produto e permitem citar suas regras. Elas não autorizam acesso aos dados de uma loja. O saldo de um código específico exige leitura autenticada e permitida; não pode ser inferido desta documentação.

O Markdown é gerado a partir do mesmo conteúdo editorial. Os SVGs têm equivalentes em texto. Os índices de conhecimento são documentais, não ferramentas para executar operações no gifty.

## Se precisar de ajuda com um caso

Identifique a etapa, a referência da operação e o resultado observado. O atendimento humano usa o canal de WhatsApp do gifty; esta documentação não inicia conversa nem confirma o recebimento de um caso. Clicar em um link não equivale a uma mensagem recebida.

[Guia de emissão e entrega](/pt-BR/issue-and-deliver) · [Conceito de saldo](/pt-BR/balance)

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

## Continue explorando

* [Entender o saldo e o resgate parcial](/pt-BR/balance)
* [Links públicos e dados privados](/pt-BR/technical-private-links)
* [Documentação para assistentes](/pt-BR/docs-for-agents)