Saltar al contenido principal
— Tutorial de configuración

Gestiona las claves asignadas, revocadas y devueltas por pedido

Cada pedido de Shopify que contiene un producto con clave de licencia recibe una o más claves en el momento de la aprobación antifraude. Alva Digital Downloads las muestra en la página de detalle del pedido, donde puedes revocar una clave (sacarla de circulación de forma permanente) o devolver una clave sin usar al pool para que el siguiente pedido la reclame.

Estados de clave en Alva

Cada clave de licencia tiene uno de cuatro estados, que reflejan dónde está en su ciclo de vida:

  • AVAILABLE — en el pool, esperando a ser asignada.
  • ASSIGNED — adjunta a una fila PurchaseLicenseKey de un pedido de cliente.
  • REVOKED — sacada manualmente del pool, nunca se vuelve a emitir.
  • RETURNED — fue asignada y luego liberada antes de que el cliente la viera; la clave subyacente vuelve a AVAILABLE con un rastro de auditoría en la fila de la compra.
AVAILABLE → ASSIGNED   (paid order, fraud-approved)
ASSIGNED  → REVOKED    (Revoke — terminal)
ASSIGNED  → AVAILABLE  (Return — only if not viewed)

Revoca una clave de un pedido

Revocar es una acción dura: la clave pasa a REVOKED, recibe un sello revokedAt en la fila de la compra y nunca se ofrece a otro pedido. La copia que el cliente tiene de la cadena de la clave no cambia — si tu sistema downstream consulta un registro central al activar, la clave fallará allí.

  1. Abre el pedido en Pedidos y baja a la sección Claves de licencia.
  2. En la fila de la clave asignada, haz clic en Revocar.
  3. Confirma en el modal. La fila pasa a Revocada y desaparece de la página de cuenta del cliente al recargarse.
Captura de pantalla necesaria

Página de detalle del pedido en el admin de Alva. Muestra la tarjeta Claves de licencia con una clave listada, el código de la clave parcialmente enmascarado y el botón Revocar resaltado con un recuadro rojo. Sin datos reales de clientes visibles.

La acción Revocar en una fila de clave de licencia asignada.

Devuelve una clave sin revocar

Usa Devolver cuando el cliente dice que la clave no funcionó y quieres una clave nueva en el pedido sin quemar la anterior. Alva mueve la original de vuelta a AVAILABLE, registra un sello returnedAt y el siguiente pedido en cola la reclama. Devolver solo está habilitado mientras el cliente todavía no haya visto la clave.

  1. Abre el pedido y baja a Claves de licencia.
  2. Haz clic en Devolver en la fila de la clave afectada y confirma.
  3. Haz clic en Asignar nueva clave para reclamar la siguiente clave disponible y luego reenvía el email de entrega.
Captura de pantalla necesaria

Página de detalle del pedido en el admin de Alva. Muestra la tarjeta Claves de licencia con la acción Devolver visible junto a Revocar. Incluye una pequeña insignia "Aún no vista" en la fila de la clave para que la precondición quede clara.

La acción Devolver — disponible solo mientras el cliente no haya visto la clave.

Qué ven los clientes

Las claves revocadas desaparecen de la página de cuenta del cliente y de la página de descarga del estado del pedido al cargar — solo quedan los enlaces de archivo. Las claves devueltas también caen, ya que la fila de asignación se elimina. Ninguna acción envía notificación: empareja Revocar con un email de reembolso y empareja Devolver con una asignación nueva más un reenvío manual.

Preguntas frecuentes

¿Puedo deshacer una revocación?

No. Revocar es permanente — la clave no puede volver a Available. Si revocaste por error, sube una clave nueva al mismo grupo y asígnala manualmente al pedido.

¿Por qué el botón Devolver está en gris?

Devolver solo está disponible mientras el cliente no haya visto la clave. Una vez que el cliente abre el email de entrega o la página de descargas y la clave queda marcada como vista, solo queda disponible Revocar.

¿El cliente recibe una notificación nueva tras asignar una clave nueva?

No sale ningún email automático para una reasignación manual. Usa la acción Reenviar email del pedido tras asignar la clave de repuesto para que el cliente reciba el código nuevo.

Ver también

¿Te ha resultado útil?

¿Sigues atascado? Escríbenos.

Última actualización 2026-05-06