PARCIAL Verificado contra producción · wb-services v3.53.0 · 24 ago 2026
Lealtad

Ciclo de vida de tarjeta

Una tarjeta tiene un estado: activa ⇄ inactiva, más expirada. Desactivar es un cambio suave y reversible. No se borra nada, y el saldo se congela. Mientras está inactiva, la tarjeta no gana ni canjea, y el pase en la billetera se pone en gris.

Activagana y canjea
→
Desactivarestado → inactiva
→
Inactivasaldo congelado · pase en gris
→
Reactivarestado → activa

Nada se borra. La tarjeta se puede reactivar después.

PARCIAL — Desactivar y Reactivar están trazados y verificados. Inscripción y expiración están sin trazar.

Preguntas frecuentes

Si desactivo la tarjeta, ¿el cliente la sigue teniendo en la billetera, solo que no escanea?
Sí. El pase queda en su billetera, pero se pone en gris. Escanearlo no hace nada. Puedes reactivar la tarjeta cuando quieras. </>
¿Desactivar borra sus puntos o su historial?
No. No se borra nada. El sistema conserva el saldo y el historial. Los dos vuelven si reactivas. </>
¿Se puede volver a activar una tarjeta desactivada?
Sí. Reactívala. Un detalle: si el cliente ya borró el pase de su teléfono, debe volver a agregarlo. </>
¿Quién desactivó esta tarjeta?
Queda registrado. A diferencia del ajuste de puntos, aquí sí se guarda el usuario. </>

Bueno saber

⚠️ Dos caminos de desactivación, inconsistentes. El camino canónico es POST /…/deactivate. Existe también un DELETE legado. El legado pone la tarjeta en inactive, deja un log con el actor y sincroniza Autumn. Pero no escribe el asiento de auditoría (DEACTIVATION) ni anula el pase. Los dos caminos no son equivalentes.
Hallazgo · candidato a ticket </>
⚠️ La puerta de gana/canje ahora auto-sana las tarjetas expiradas. Una tarjeta expirada ya no bloquea. En la siguiente acción de puntos se reactiva sola. Solo inactive y disabled bloquean.
Comportamiento nuevo desde v3.32.0 </>

Comportamientos

Desactivar POST /v2/customer-cards/:id/deactivate

Deshabilita la tarjeta de forma suave. Es reversible. No se borra nada.

El texto del diálogo es la respuesta a la duda más común: «El cliente ya no podrá ganar ni canjear puntos… El pase en su billetera digital quedará en gris. No se elimina información — la tarjeta se puede reactivar después.»
El texto del diálogo es la respuesta a la duda más común: «El cliente ya no podrá ganar ni canjear puntos… El pase en su billetera digital quedará en gris. No se elimina información — la tarjeta se puede reactivar después.»
  • Cambia el estado. Pasa de activa a inactiva, en una transacción. No borra la fila. El saldo queda congelado, no en cero. Una tarjeta no se puede desactivar dos veces. </>
  • No gana ni canjea. Toda ruta de puntos rechaza el estado inactive. El trabajo de premios salta la tarjeta. </>
  • Asiento de auditoría. Escribe un asiento DEACTIVATION con el usuario que lo hizo, atómico con el cambio de estado. </>
  • Anula el pase. Google pasa a EXPIRED, Apple a voided. Si esa anulación falla, no bloquea la desactivación. También libera cupo en Autumn. No avisa al cliente. </>

Acceso: cualquier usuario de negocio con el sistema de tarjetas.

Reactivar POST /v2/customer-cards/:id/reactivate

El inverso: vuelve la tarjeta a activa.

  • Solo funciona desde inactive. Vuelve la tarjeta a active, escribe un asiento REACTIVATION y restaura el pase. Vuelve a consumir cupo en Autumn. </>
  • ⚠️ Salvedad del pase. Si el cliente borró el pase a mano, nadie puede re-agregarlo en remoto. El cliente debe re-inscribirse. </>
Mapa de código — para ingeniería