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

# The gift card lifecycle

A reference for products, orders, issuance, delivery and redemption.

[Read the complete explanation as text.](#from-product-to-redemption)

A gift card moves through different processes. Distinguishing them helps you find where action is needed and avoids mistaking a payment, a message or a redemption for another event.

## From product to redemption

| Stage             | What it represents                               | What it does not prove on its own                      |
| ----------------- | ------------------------------------------------ | ------------------------------------------------------ |
| Gift card product | The option published in the store catalog.       | That someone has bought it.                            |
| Paid order        | The purchase that needs processing.              | That every unit is configured and delivered.           |
| Configuration     | The details needed for each gift and recipient.  | That issuance has finished.                            |
| Issuance          | Creating the gift card for a unit.               | That the recipient received the message.               |
| Delivery          | Attempts and outcomes of sending that gift card. | That the recipient opened or redeemed it.              |
| Public gift       | The page the recipient opens through their link. | A new purchase or completed redemption.                |
| Redemption        | Using value and updating its balance.            | That the whole card is exhausted when use was partial. |

Manual issuance starts from a merchant action without requiring a checkout order. Documentation distinguishes that entry point from an online purchase.

## Current integrations and limits

Tiendanube is the ecommerce platform for this flow. Marketing Nube has its own connection and audiences surface; consult that integration for its scope. Neither connection implies a public transactional gifty API exists.

## Public API: not available

**The public transactional API is not available.** This pilot documents no public endpoint for issuing gift cards, checking balances or redeeming. Do not invoke `POST /gift-cards` or infer a contract from internal app routes.

A future API reference must define authentication, permissions, idempotency, errors, limits and versioning against an approved implementation. This page announces neither an API date nor a contract.

## Information for agents

Public pages explain the product and support citations of its rules. They do not authorize access to store data. The balance of a specific code requires an authenticated, permitted read; it cannot be inferred from these docs.

Markdown is generated from the same editorial content. SVGs have text equivalents. Knowledge indexes provide documentation, not tools to execute operations in gifty.

## If you need help with a case

Identify the stage, operation reference and observed outcome. Human support uses gifty's WhatsApp channel; this documentation does not start a conversation or confirm receipt of a case. Clicking a link is not the same as a received message.

[Issuance and delivery guide](/en/issue-and-deliver) · [Balance concept](/en/balance)

[Read this page as Markdown](/exports/en/gift-lifecycle.md)

## Explore next

* [Understand balances and partial redemption](/en/balance)
* [Public links and private data](/en/technical-private-links)
* [Documentation for assistants](/en/docs-for-agents)