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

# El ciclo de una gift card

Una referencia para distinguir producto, pedido, emisión, entrega y canje.

[Leé la explicación completa en texto.](#del-producto-al-canje)

Una gift card pasa por procesos diferentes. Separarlos permite detectar dónde hace falta actuar y evita confundir un pago, un envío o un canje con otro evento.

## Del producto al canje

| Etapa                 | Qué representa                                         | Qué no prueba por sí sola                                    |
| --------------------- | ------------------------------------------------------ | ------------------------------------------------------------ |
| Producto de gift card | La opción que se publica en el catálogo de la tienda.  | Que alguien la haya comprado.                                |
| Pedido pagado         | La compra que debe procesarse.                         | Que todas las unidades estén configuradas y entregadas.      |
| Configuración         | Los datos necesarios para cada regalo y destinatario.  | Que la emisión haya finalizado.                              |
| Emisión               | La creación de la gift card de una unidad.             | Que el destinatario haya recibido el mensaje.                |
| Entrega               | Los intentos y resultados del envío de esa gift card.  | Que el destinatario la haya abierto o canjeado.              |
| Regalo público        | La página que abre el destinatario mediante su enlace. | Una nueva compra o un canje completado.                      |
| Canje                 | El uso de valor y la actualización de su saldo.        | Que toda la gift card se haya agotado si el uso fue parcial. |

Una emisión manual empieza desde la acción del comercio, sin exigir un pedido del checkout. La documentación distingue esa puerta de entrada de la compra online.

## Integraciones actuales y límites

Tiendanube es la plataforma de ecommerce de este recorrido. Marketing Nube tiene una superficie propia de conexión y audiencias; su alcance debe consultarse en esa integración. Ninguna de estas conexiones significa que exista una API pública transaccional de gifty.

## API pública: no disponible

**La API pública transaccional no está disponible.** No hay un endpoint público documentado en esta documentación para emitir, consultar saldos o canjear. No invoques `POST /gift-cards` ni deduzcas un contrato a partir de rutas internas de la app.

Una futura referencia API deberá definir autenticación, permisos, idempotencia, errores, límites y versionado sobre una implementación aprobada. Esta página no anuncia fecha ni contrato de esa API.

## Información para agentes

Las páginas públicas sirven para explicar el producto y citar sus reglas. No autorizan acceso a datos de una tienda. El saldo de un código concreto requiere una lectura autenticada y permitida; no se infiere de esta documentación.

El Markdown de estas páginas se genera desde el mismo contenido editorial. Los SVG tienen equivalentes de texto. Los índices de conocimiento son documentales: no son herramientas para ejecutar operaciones en gifty.

## Si necesitás ayuda con un caso

Identificá la etapa, la referencia de la operación y el resultado observado. El soporte humano se atiende por el canal de WhatsApp de gifty; esta documentación no inicia una conversación ni confirma recepción de un caso. Un click en un enlace no equivale a un mensaje recibido.

[Guía de emisión y entrega](/es/issue-and-deliver) · [Concepto de saldo](/es/balance)

[Leer esta página en Markdown](/exports/es/gift-lifecycle.md)

## Seguí explorando

* [Entender el saldo y el canje parcial](/es/balance)
* [Enlaces públicos y datos privados](/es/technical-private-links)
* [Documentación para asistentes](/es/docs-for-agents)