> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/transit-digitization/es/comenzar/conceptos/gestion-del-ciclo-de-vida.md).
# Gestión del ciclo de vida
La gestión del ciclo de vida (LCM) es muy importante para ofrecer una experiencia de usuario óptima durante toda la vida útil de las cuentas de tarjeta y las tarjetas digitales.
La sección siguiente describe los aspectos fundamentales de LCM.
Para empezar, detalles sobre las 6 acciones principales de LCM:
* Aprovisionamiento
* Pausar y recuperar
* Suspender y reanudar
* Eliminar
A continuación, una vista de la gestión de estados de la cuenta de tarjeta y la tarjeta digital dentro de la solución D1 Transit.
### Acciones de gestión del ciclo de vida
#### Aprovisionamiento
El aprovisionamiento añade una tarjeta digital de tránsito a las carteras digitales. Hay 2 formas de aprovisionar una tarjeta digital:
* Desde la cartera (también llamado DCI para Apple)
* Desde la aplicación del operador de tránsito (también llamado aprovisionamiento en la aplicación para Apple, aprovisionamiento push para Google)
#### Pausar y recuperar
Pausar una tarjeta digital elimina temporalmente su instancia de la cartera, manteniendo la asociación relativa de la cuenta de tarjeta con la cuenta de cartera del usuario. La pausa puede ser iniciada tanto por el emisor como por el usuario.
Los usuarios pueden "recuperar" o añadir una tarjeta desde la cuenta de cartera del usuario a la cartera.
#### Suspender y reanudar
Cuando una tarjeta digital de tránsito está suspendida en la cartera, la tarjeta sigue siendo visible y accesible para el usuario, pero las capacidades NFC están deshabilitadas.
Reanudar una tarjeta revierte los efectos de una suspensión. La reanudación puede ser iniciada tanto por el emisor como por el usuario.
#### Eliminar
La eliminación desvincula la tarjeta de la cuenta de cartera del usuario y la elimina del ecosistema de carteras digitales. Tanto el emisor de tránsito como el usuario pueden solicitar la eliminación.
### Estados
#### Cuenta de tarjeta
La gestión de estados de la cuenta de tarjeta dentro de la plataforma D1 Transit es la siguiente.
Una cuenta de tarjeta puede estar en cualquiera de estos estados:
* **activa**: el estado en el que se encuentra una cuenta de tarjeta cuando se realiza correctamente una compra para el aprovisionamiento inicial.
* **en pausa**: el estado en el que se encuentra una cuenta de tarjeta cuando la pausa se ha completado correctamente (es decir, la tarjeta digital vinculada a esta cuenta de tarjeta fue eliminada)
* **cancelada**: la cuenta de tarjeta pasa a este estado cuando el emisor de tránsito lo solicita a través de una **cancelCardAccount** llamada a la API. Es un estado irreversible.
{% hint style="info" %}
la referencia de la cuenta de tarjeta se elimina por completo de la plataforma D1 Transit cuando no hay ninguna solicitud de aprovisionamiento desde la cartera digital dentro de un TTL configurado.
{% endhint %}
```mermaid
%%{init: {
"theme": "base",
"htmlLabels": false,
"themeVariables": {
"background": "#F5FBFF",
"primaryColor": "#EAF8FF",
"primaryBorderColor": "#00B5D8",
"primaryTextColor": "#061A8A",
"secondaryColor": "#DDF5FF",
"secondaryBorderColor": "#00B5D8",
"tertiaryColor": "#FFFFFF",
"lineColor": "#061A8A",
"textColor": "#061A8A",
"labelBackgroundColor": "#BBEBFF",
"fontSize": "12px",
"fontFamily": "Arial, Helvetica, sans-serif"
},
"themeCSS": ".edgeLabel rect, .labelBkg, .stateLabelBkg { fill: #BBEBFF !important; opacity: 1 !important; transform: scaleX(1.18); transform-box: fill-box; transform-origin: center; } .edgeLabel text, .edgeLabel tspan, .stateLabel, .stateLabel tspan { fill: #061A8A !important; }",
"state": {
"nodeSpacing": 240,
"rankSpacing": 240
}
}}%%
stateDiagram-v2
[*] --> ACTIVE : purchaseProducts or
preparePushProvisioning
Bundle procesado para
el aprovisionamiento inicial
state "activa" as ACTIVE
state "en pausa" as PARKED
state "cancelada" as CANCELLED
ACTIVE --> PARKED : pausa completada
PARKED --> ACTIVE : restaurar
ACTIVE --> CANCELLED : cancelCardAccount
recibido del
emisor de tránsito
PARKED --> CANCELLED : cancelCardAccount
recibido del
emisor de tránsito
ACTIVE --> [*] : no hay solicitud de aprovisionamiento
desde la cartera digital
dentro del TTL configurado
```
#### Tarjeta digital
La gestión de estados de la tarjeta digital dentro de la plataforma D1 Transit es la siguiente.
Una tarjeta digital puede estar en cualquiera de estos estados:
* **creada**: el estado inicial de una tarjeta digital, antes de su aprovisionamiento en un dispositivo.
* **aprovisionamiento\_fallido**: en caso de que falle el aprovisionamiento inicial, una tarjeta digital pasa a este estado.
* **activa**: el estado en el que se encuentra una tarjeta digital cuando está completamente aprovisionada en un dispositivo.
* **suspendida (cartera o emisor)**: la tarjeta digital pasa a este estado cuando el emisor de tránsito o la cartera digital solicita la suspensión de esta tarjeta digital.
* **desvinculada**: la tarjeta digital pasa a este estado cuando se realiza una solicitud de **pausa** pero no hay garantía de que se elimine del dispositivo; es decir, cuando se activa desde la nube o desde el lado del emisor de tránsito.
* **eliminada**: la tarjeta digital pasa a este estado cuando hay una confirmación de que la tarjeta digital fue eliminada del dispositivo.
{% hint style="info" %}
la referencia de la tarjeta digital se elimina por completo de la plataforma D1 Transit cuando no hay ninguna solicitud de aprovisionamiento desde la cartera digital dentro de un TTL configurado.
{% endhint %}
Las transiciones del estado de una tarjeta digital son ligeramente diferentes entre ABT y CBT.
**Ticketing basado en cuenta**
El diagrama de estados a continuación ilustra las diferentes transiciones en el contexto ABT.
```mermaid
%%{init: {
"theme": "base",
"htmlLabels": false,
"themeVariables": {
"background": "#F5FBFF",
"primaryColor": "#EAF8FF",
"primaryBorderColor": "#00B5D8",
"primaryTextColor": "#061A8A",
"secondaryColor": "#DDF5FF",
"secondaryBorderColor": "#00B5D8",
"tertiaryColor": "#FFFFFF",
"lineColor": "#061A8A",
"textColor": "#061A8A",
"labelBackgroundColor": "#BBEBFF",
"fontSize": "12px",
"fontFamily": "Arial, Helvetica, sans-serif"
},
"themeCSS": ".edgeLabel rect, .labelBkg, .stateLabelBkg { fill: #BBEBFF !important; opacity: 1 !important; transform: scaleX(1.18); transform-box: fill-box; transform-origin: center; } .edgeLabel text, .edgeLabel tspan, .stateLabel, .stateLabel tspan { fill: #061A8A !important; }",
"state": {
"nodeSpacing": 350,
"rankSpacing": 350
}
}}%%
stateDiagram-v2
state "creada" as CREATED
state "activa" as ACTIVE
state "aprovisionamiento_fallido" as FAILED
state "desvinculada" as UNLINKED
state "suspendida_cartera" as SUSPENDED_WALLET
state "suspendida_emisor" as SUSPENDED_ISSUER
state "eliminada" as DELETED
[*] --> CREATED : purchaseProducts or
preparePushProvisioning
Bundle procesado
CREATED --> ACTIVE : aprovisionamiento completado
CREATED --> FAILED : el aprovisionamiento falló
CREATED --> [*] : no hay solicitud de aprovisionamiento
desde la cartera digital
dentro del TTL configurado
FAILED --> ACTIVE : aprovisionamiento completado
ACTIVE --> UNLINKED : desvincular de la cartera digital
(iniciado desde el dispositivo o la nube)
o desde el emisor de tránsito
SUSPENDED_WALLET --> UNLINKED : desvincular de la cartera digital
(iniciado desde el dispositivo o la nube)
o desde el emisor de tránsito
SUSPENDED_ISSUER --> UNLINKED : desvincular de la cartera digital
(iniciado desde el dispositivo o la nube)
o desde el emisor de tránsito
UNLINKED --> DELETED : confirmación de eliminación
desde la cartera digital
ACTIVE --> SUSPENDED_WALLET : suspender desde
la cartera digital
SUSPENDED_WALLET --> ACTIVE : reanudar desde
la cartera digital
ACTIVE --> SUSPENDED_ISSUER : suspender desde
el emisor de tránsito
SUSPENDED_WALLET --> SUSPENDED_ISSUER : suspender desde
el emisor de tránsito
SUSPENDED_ISSUER --> ACTIVE : reanudar desde
el emisor de tránsito
ACTIVE --> DELETED : cancelCardAccount
desde el emisor de tránsito
SUSPENDED_WALLET --> DELETED : cancelCardAccount
desde el emisor de tránsito
SUSPENDED_ISSUER --> DELETED : cancelCardAccount
desde el emisor de tránsito
FAILED --> DELETED : cancelCardAccount
desde el emisor de tránsito
DELETED --> ACTIVE : restaurar
```
**Ticketing basado en tarjeta**
El diagrama de estados a continuación ilustra las diferentes transiciones en el contexto CBT.
```mermaid
%%{init: {
"theme": "base",
"htmlLabels": false,
"themeVariables": {
"background": "#F5FBFF",
"primaryColor": "#EAF8FF",
"primaryBorderColor": "#00B5D8",
"primaryTextColor": "#061A8A",
"secondaryColor": "#DDF5FF",
"secondaryBorderColor": "#00B5D8",
"tertiaryColor": "#FFFFFF",
"lineColor": "#061A8A",
"textColor": "#061A8A",
"labelBackgroundColor": "#BBEBFF",
"fontSize": "12px",
"fontFamily": "Arial, Helvetica, sans-serif"
},
"themeCSS": ".edgeLabel rect, .labelBkg, .stateLabelBkg { fill: #BBEBFF !important; opacity: 1 !important; transform: scaleX(1.18); transform-box: fill-box; transform-origin: center; } .edgeLabel text, .edgeLabel tspan, .stateLabel, .stateLabel tspan { fill: #061A8A !important; }",
"state": {
"nodeSpacing": 240,
"rankSpacing": 240
}
}}%%
stateDiagram-v2
state "creada" as CREATED
state "activa" as ACTIVE
state "aprovisionamiento_fallido" as FAILED
state "suspendida_cartera" as SUSPENDED_WALLET
state "suspendida_emisor" as SUSPENDED_ISSUER
state "desvinculada" as UNLINKED
state "eliminada" as DELETED
[*] --> CREATED : purchaseProducts or
preparePushProvisioning
Bundle procesado
CREATED --> ACTIVE : aprovisionamiento completado
CREATED --> FAILED : el aprovisionamiento falló
CREATED --> [*] : no hay solicitud de aprovisionamiento
desde la cartera digital
dentro del TTL configurado
FAILED --> ACTIVE : aprovisionamiento completado
ACTIVE --> SUSPENDED_WALLET : suspender desde
la cartera digital
ACTIVE --> SUSPENDED_ISSUER : suspender desde
el emisor de tránsito
SUSPENDED_WALLET --> ACTIVE : reanudar desde
la cartera digital
SUSPENDED_ISSUER --> ACTIVE : reanudar desde
el emisor de tránsito
SUSPENDED_WALLET --> SUSPENDED_ISSUER : suspender desde
el emisor de tránsito
ACTIVE --> UNLINKED : desvincular de la cartera digital
(iniciado desde el dispositivo o la nube)
o emisor de tránsito
SUSPENDED_WALLET --> UNLINKED : desvincular de la cartera digital
(iniciado desde el dispositivo o la nube)
o desde el emisor de tránsito
SUSPENDED_ISSUER --> UNLINKED : desvincular de la cartera digital
(iniciado desde el dispositivo o la nube)
o desde el emisor de tránsito
ACTIVE --> DELETED : cancelCardAccount
desde el emisor de tránsito
FAILED --> DELETED : cancelCardAccount
desde el emisor de tránsito
SUSPENDED_WALLET --> DELETED : cancelCardAccount
desde el emisor de tránsito
SUSPENDED_ISSUER --> DELETED : cancelCardAccount
desde el emisor de tránsito
UNLINKED --> DELETED : confirmación de eliminación
desde la cartera digital
DELETED --> ACTIVE : restaurar
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.payments.thalescloud.io/transit-digitization/es/comenzar/conceptos/gestion-del-ciclo-de-vida.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.