Entender los estados del ciclo de vida de tarjetas de regalo

Customer App puede mostrar denominaciones de tarjetas de regalo, punto de entrada de compra, historial de tarjetas, opciones para enviarlas y superficies de canje cuando lo permitan la configuración y la cuenta actuales. Son etapas financieras, de entrega, correo electrónico, billetera y proveedor independientes. Una tarjeta, estado, mensaje o resultado de navegación visible no demuestra que se haya completado la etapa siguiente.

Las credenciales de regalo y los datos del destinatario son privados

Nunca incluyas un código de tarjeta de regalo, contraseña, destinatario, remitente, mensaje, importe, valor de billetera ni datos relacionados de cuenta/pedido en documentación, capturas, registros o notas de soporte. Esta guía no indica acciones de compra, envío, canje, billetera, pago ni pedido.

Etapas del ciclo de vida de una tarjeta de regalo

Etapa	Qué puede representar	Qué no demuestra
Elección de producto/denominación	Un producto de tarjeta de regalo candidato a la venta para la configuración actual	Disponibilidad, importe final, destinatario, pago ni creación de tarjeta
Carrito y pago	Un producto de tarjeta de regalo en el carrito y un recorrido de pago/cobro	Pago correcto, creación de pedido ni entrega de la tarjeta de regalo
Procesamiento de pedido pagado	Ordering.co puede procesar un pedido de tarjeta de regalo pagado que cumpla los requisitos	Creación de tarjeta exactamente una vez, seguridad de la credencial, entrega por correo ni crédito en la billetera
Creación de tarjeta de regalo	Se puede crear un registro de tarjeta y una credencial para un pedido apto	Entrega al destinatario, activación, canje ni saldo utilizable
Entrega por correo o proveedor	Se puede poner en cola o aceptar una solicitud de entrega en un sistema de correo/proveedor	Que el destinatario la reciba o vea, credencial válida ni activación de tarjeta
Lista/detalles de tarjetas	El historial actual de la cuenta puede mostrar estados devueltos de tarjeta/pedido	Titularidad, historial completo, estado actual de la credencial ni conciliación financiera
Enviar desde los detalles del pedido	Un pedido de tarjeta de regalo pendiente puede ofrecer un formulario de envío	Envío exactamente una vez, destinatario válido, entrega del proveedor ni transición de estado
Canje	Una comprobación de credencial puede solicitar el canje	Uso único, crédito en billetera, titularidad de cuenta ni saldo utilizable
Crédito en billetera y uso posterior	Un evento/saldo de billetera puede reflejar el canje y el pago posterior puede usarlo	Canje atómico, saldo actual, finalización del pago/pedido ni reversibilidad

No se debe inferir una etapa a partir de la interfaz de otra.

Visibilidad de denominaciones y formularios

Los productos de tarjeta de regalo, etiquetas de denominación, controles de compra, campos de destinatario, formularios de envío/canje, áreas de billetera y secciones de estado son condicionales. Su visibilidad puede depender de la configuración del proyecto, la cuenta/sesión, el catálogo, la plataforma, el pago, el estado del pedido, el proveedor y la autorización actual.

El importe mostrado para un producto de tarjeta de regalo es un precio candidato del producto, no un valor garantizado de tarjeta, cargo, crédito en billetera ni saldo utilizable. Abrir un formulario solo representa un estado previo a la acción.

Estados pendiente, enviado, activado y desconocido

Estado visible	Interpretación segura
Cargando	No se ha resuelto el estado del producto, la tarjeta, el pedido o la acción.
Lista vacía	No se devolvió un registro de tarjeta autorizado para la sección actual; no se infiere ausencia global.
Pendiente	Un registro de tarjeta/pedido devuelto no ha alcanzado un estado posterior; el pago, la creación y la entrega aún pueden diferir.
Enviado	Un estado devuelto indica que avanzó una etapa de envío; la entrega, recepción, validez de credencial y canje siguen siendo independientes.
Activado o canjeado	Un estado devuelto indica que avanzó una etapa de canje/activación; el crédito, saldo restante, uso posterior y pago del pedido siguen siendo independientes.
Error	La compra, pago, creación, envío, proveedor, canje, billetera o asignación pueden fallar por separado.
Desconocido	Se perdió una respuesta, se duplicó trabajo o cambió la cuenta/proyecto/sesión antes de conciliar.

Una etiqueta de estado no es una credencial, recibo del proveedor ni prueba de que se haya completado la conciliación financiera.

La compra, creación de tarjeta y pago se completan por separado

La compra empieza con un producto candidato; después, el carrito y el pago pueden cambiar el estado del carrito, cobro y pedido. La creación de la tarjeta es una responsabilidad de entrega posterior que debe vincularse a un pedido pagado autorizado y ejecutarse exactamente una vez.

Límite	Contrato requerido
Producto/carrito	Producto habilitado actualmente y revisión inmutable del producto/precio
Pago/cobro	Cuenta, carrito, negocio, moneda e importe autorizados y un recibo de operación de pago
Pedido	Un resultado actual autorizado del pedido, no solo navegación
Creación de tarjeta	Clave única de entrega pedido-producto y generación idempotente de credencial
Fallo/recuperación	Estado exacto pendiente/fallido/parcial sin cargo, pedido ni tarjeta duplicados

El éxito del pago/proveedor o un pedido visible es una entrada para conciliar, no prueba de que se haya creado ni enviado una tarjeta de regalo.

Límites del correo electrónico y los envíos duplicados

Enviar una tarjeta de regalo puede exponer campos de destinatario, remitente, título y mensaje y atravesar los límites de proveedor de correo, trabajo en cola, complemento, push y estado del pedido. Son etapas privadas y con efectos.

El resultado del envío sigue sin resolverse a menos que se validen la tarjeta y el pedido autorizados actuales, se derive al destinatario de ese contexto, se minimice el contenido, se use una operación de entrega idempotente y se devuelva un estado seguro. Los toques repetidos, reintentos, repeticiones del worker/proveedor o respuestas perdidas no deben generar entregas ni transiciones de estado duplicadas.

La aceptación del proveedor no demuestra que el destinatario haya recibido o visto la tarjeta. El contenido push o de la pantalla bloqueada no debe incluir credenciales, datos del destinatario ni contenido sensible del mensaje.

Canje, crédito en billetera y uso

El canje puede requerir una credencial secreta y revelar datos personales identificables de la tarjeta o contenido del mensaje. Esos valores no deben aparecer en esta guía ni en evidencia de soporte.

El canje, consumo de tarjeta, creación del evento de billetera, actualización del saldo, estado de tarjeta, notificación y uso posterior de la billetera requieren un resultado transaccional o recuperable bloqueado único. El canje concurrente, duplicado, repetido, de una cuenta ajena o de un proyecto obsoleto no debe otorgar crédito dos veces ni consumir la tarjeta sin un recibo coincidente de billetera.

Que aparezca un resultado de canje o un saldo no demuestra que un carrito, pago o pedido posterior haya usado el crédito correctamente.

Minimización de credenciales e información personal

Las respuestas de listas de tarjetas de regalo, pedidos, detalles de tarjeta, correo, push, billetera y proveedor deben ser específicas al propósito y mínimas. Las credenciales deben ocultarse por defecto y no deben aparecer en grafos amplios de pedido o cuenta.

El estado público/seguro para clientes puede identificar únicamente una clase del ciclo de vida sin valores, como pendiente, enviado, activado, no disponible o desconocido. No debe revelar credencial, destinatario, remitente, mensaje, precio del producto, valor de tarjeta, importe de billetera, referencia de pedido, identidad de cuenta ni datos del proveedor.

Resultados simultáneos y parciales

Resultado	Interpretación segura
Se completó la compra, pero no aparece una tarjeta	El pago, el pedido y la creación de tarjeta pueden estar pendientes o ser parciales.
Aparece la tarjeta, pero no está claro el estado de entrega	La creación y la entrega del proveedor son etapas distintas.
El envío informa éxito, pero el estado sigue pendiente	Las capas de proveedor/trabajo/estado del pedido pueden no coincidir.
Ocurre una solicitud de envío duplicada	No se han demostrado la entrega exactamente una vez ni la transición de estado.
El canje tiene éxito, pero no cambia la billetera	El consumo y el crédito pueden ser parciales.
Cambia la billetera, pero no el estado de la tarjeta	Los estados de billetera/tarjeta/notificación pueden tener revisiones distintas.
Compiten dos intentos de canje	El bloqueo, uso único, crédito en billetera y reversión no están resueltos.
Cambia la cuenta/proyecto/sesión	Rechaza las funciones de retorno anteriores de tarjeta, proveedor, billetera, correo y push.
Se pierde la respuesta	Mantén desconocidos los resultados de compra, tarjeta, entrega, canje, billetera y uso; no repitas automáticamente.

Solucionar problemas de forma segura

• Trata compra, pago, pedido, creación de tarjeta, correo, envío, canje, billetera y uso como estados separados.
• No vuelvas a enviar, canjear, comprar, cambiar de cuenta/proyecto ni realizar otro pedido para diagnosticar un resultado desconocido.
• No copies ni reveles credenciales, destinatario, mensaje, importe, billetera, pedido, proveedor, correo o contenido push.
• Usa únicamente clases de estado sin valores, como “creación de tarjeta de regalo sin resolver”, “entrega desconocida” o “crédito de billetera parcial”.
• Que falte una tarjeta o fila del historial no debe revelar existencia ni titularidad.

Límites de accesibilidad

Las opciones de producto/denominación, carga/vacío/error, secciones de estado, filas, formularios de compra/envío/canje, visibilidad de credenciales, consecuencias destructivas o duplicadas, progreso del proveedor, estado de la billetera y resultados desconocidos requieren nombres, roles, valores, orden del foco, anuncios y retorno seguro y predecible. El texto grande, teclado, lector de pantalla, Atrás, cuadro modal, retorno del proveedor y movimiento reducido deben conservar el estado del ciclo de vida sin exponer datos privados.

La configuración del producto de regalo, el pago, la entrega, el canje, el estado de cuenta y el comportamiento del proveedor pueden cambiar por separado. Usa el estado actual de la aplicación y no repitas una compra, envío, canje o acción de billetera si su resultado es desconocido. Estos límites no establecen el comportamiento financiero, de entrega, privacidad, accesibilidad ni producción actual.

Guías relacionadas: Revisar el carrito antes del pago · Revisar los límites de los métodos de pago · Revisar billeteras y fidelidad · Entender los detalles y el estado del pedido · Entender los límites de las notificaciones push · Usar la aplicación sin conexión y volver a conectarse