> ## 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.
# The gift card lifecycle
> A reference for products, orders, issuance, delivery and redemption.
export const GiftJourney = ({locale = "es-AR", fallback, fallbackHref}) => {
const L = locale === "en" ? "en" : locale === "pt-BR" ? "pt" : "es";
const T = {
es: {
t: "El recorrido de un regalo",
step: "Paso",
of: "de",
prev: "Paso anterior",
next: "Paso siguiente",
play: "Reproducir",
pause: "Pausar",
rule: "Regla clave",
q: "En cola",
d: "Entregado",
on: "Online",
ct: "Mostrador",
fb: "Leé estas reglas en texto",
s: [["Producto", "El producto define la oferta", "Montos, vigencia, textos y diseño definen la oferta. El producto se usa para vender o emitir regalos.", "Un producto todavía no es un regalo: nadie tiene saldo hasta la emisión."], ["Pedido", "Un pedido puede tener varias unidades", "Cada unidad se configura por separado: para quién es, con qué mensaje y cuándo se envía. Tres unidades son tres futuros regalos.", "Cada unidad pendiente necesita su configuración; otras unidades del pedido pueden estar emitidas."], ["Emisión", "La emisión crea cada regalo y su saldo", "Al emitirse, cada unidad se convierte en un regalo con código y saldo propios. Confirmar el pedido no demuestra que todas sus unidades estén emitidas.", "Reemitir es una emisión nueva. No reenvía nada."], ["Entrega", "La entrega envía ESE regalo", "El canal disponible lleva un regalo puntual al destinatario. En cola no demuestra entrega: revisá el resultado final en la cronología.", "Si la entrega falla, reintentala para el mismo regalo. Reemitir NO es reintentar la entrega."], ["Canje", "El canje consume el saldo", "La persona usa el saldo del regalo comprando online o en el mostrador de tu local.", "Revisá importe y comprobante. Si queda un intento pendiente, resolvelo desde la misma operación."]]
},
en: {
t: "The journey of a gift",
step: "Step",
of: "of",
prev: "Previous step",
next: "Next step",
play: "Play",
pause: "Pause",
rule: "Key rule",
q: "Queued",
d: "Delivered",
on: "Online",
ct: "Counter",
fb: "Read these rules as text",
s: [["Product", "The product defines the offer", "Amounts, validity, copy and design define the offer. The product is used to sell or issue gifts.", "A product is not a gift yet: nobody holds a balance until issuance."], ["Order", "An order can hold several units", "Each unit is configured on its own: who it is for, the message, and when it is sent. Three units are three future gifts.", "Each pending unit needs configuration; other units in the order may already be issued."], ["Issuance", "Issuance creates each gift and its balance", "At issuance, each unit becomes a gift with its own code and balance. Order confirmation does not prove every unit is issued.", "Reissuing is a new issuance. It does not resend anything."], ["Delivery", "Delivery sends THAT gift", "The available channel carries one specific gift to its recipient. Queued is not proof of delivery: check the final timeline result.", "If a delivery fails, retry it for the same gift. Reissuing is NOT retrying delivery."], ["Redemption", "Redemption consumes the balance", "The recipient spends the gift balance by buying online or at your store counter.", "Check amount and receipt. If an attempt remains pending, resolve it from the same operation."]]
},
pt: {
t: "A jornada de um presente",
step: "Etapa",
of: "de",
prev: "Etapa anterior",
next: "Próxima etapa",
play: "Reproduzir",
pause: "Pausar",
rule: "Regra-chave",
q: "Na fila",
d: "Entregue",
on: "Online",
ct: "Balcão",
fb: "Leia estas regras em texto",
s: [["Produto", "O produto define a oferta", "Valores, validade, textos e design definem a oferta. O produto é usado para vender ou emitir presentes.", "Um produto ainda não é um presente: ninguém tem saldo até a emissão."], ["Pedido", "Um pedido pode ter várias unidades", "Cada unidade é configurada separadamente: para quem é, com qual mensagem e quando será enviada. Três unidades são três futuros presentes.", "Cada unidade pendente precisa de configuração; outras unidades do pedido podem já estar emitidas."], ["Emissão", "A emissão cria cada presente e seu saldo", "Na emissão, cada unidade vira um presente com código e saldo próprios. Confirmar o pedido não comprova emissão de todas as unidades.", "Reemitir é uma nova emissão. Não reenvia nada."], ["Entrega", "A entrega envia AQUELE presente", "O canal disponível leva um presente específico ao destinatário. Na fila não comprova entrega: confira o resultado final na linha do tempo.", "Se a entrega falhar, tente de novo para o mesmo presente. Reemitir NÃO é reenviar."], ["Resgate", "O resgate consome o saldo", "A pessoa usa o saldo do presente comprando online ou no balcão da sua loja.", "Confira valor e comprovante. Se uma tentativa ficar pendente, resolva na mesma operação."]]
}
};
const c = T[L];
const [i, setI] = useState(0);
const [playing, setPlaying] = useState(false);
const [rm, setRm] = useState(false);
useEffect(() => {
const m = window.matchMedia("(prefers-reduced-motion: reduce)");
const sync = () => {
setRm(m.matches);
if (m.matches) setPlaying(false);
};
sync();
m.addEventListener("change", sync);
return () => m.removeEventListener("change", sync);
}, []);
useEffect(() => {
if (!playing || rm) return;
const id = setInterval(() => setI(s => {
if (s >= 4) {
setPlaying(false);
return 4;
}
return s + 1;
}), 5000);
return () => clearInterval(id);
}, [playing, rm]);
const s = c.s[i];
const icons = ["M3 3h8l9 9-8 8-9-9zM7 7h.01", "M4 4h6v6H4zM14 4h6v6h-6zM4 14h6v6H4zM14 14h6v6h-6z", "M4 8a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v2a2 2 0 0 0 0 4v2a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-2a2 2 0 0 0 0-4z", "M4 12l16-8-6 16-2-6z", "M5 12l5 5 9-11"];
const tk = "M0 8a8 8 0 0 1 8-8h40a8 8 0 0 1 8 8v20a6 6 0 0 0 0 12v20a8 8 0 0 1-8 8H8a8 8 0 0 1-8-8V48a6 6 0 0 0 0-12z";
const scenes = [, {[0, 1, 2].map(k => )}, {[0, 1, 2].map(k => )}, {c.q}{c.d}, {c.on}{c.ct}];
return
;
};
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)