Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.

Gestionar el ciclo de vida de la tarjeta

Ciclo de vida y operaciones de la tarjeta

El diagrama a continuación muestra los diferentes estados del ciclo de vida de una tarjeta.

Además del estado, cada tarjeta expone una ongoingOperation propiedad.

Esta propiedad indica si se ha iniciado la renovación y se espera la activación de la tarjeta reemitida.

ongoingOperation está disponible tanto en la API de D1 como en el SDK de D1.

Operaciones del ciclo de vida de la tarjeta

Puede realizar operaciones del ciclo de vida de la tarjeta a través de:

  • API de D1

  • SDK de D1

  • portal de D1

Para obtener detalles de la API, use las páginas de referencia de la API de D1 en Integrar la API de D1.

Motivos de la operación del ciclo de vida

Proporcione un motivo cada vez que realice una operación del ciclo de vida de la tarjeta.

Las tablas a continuación resumen los motivos disponibles y su impacto.

Motivos de suspensión

Motivo
Descripción

CARD_LOST

La tarjeta ha sido reportada como perdida. Puede: - reanudar la tarjeta usando el motivo CARD_FOUND. - solicitar una tarjeta de reemplazo.

CARD_STOLEN

La tarjeta ha sido reportada como robada. La tarjeta permanece suspendida hasta que solicite explícitamente un reemplazo.

CARD_BROKEN

La tarjeta está dañada y ya no funciona. La tarjeta permanece suspendida hasta que solicite explícitamente un reemplazo.

FRAUD

La tarjeta está comprometida. La tarjeta permanece suspendida hasta que solicite explícitamente un reemplazo.

USER_DECISION

El usuario final ha decidido suspender temporalmente la tarjeta. La tarjeta puede reanudarse con USER_DECISION o ISSUER_DECISION.

ISSUER_DECISION

El emisor ha decidido suspender temporalmente la tarjeta. La tarjeta puede reanudarse con ISSUER_DECISION.

Motivos de reanudación

Motivo
Descripción

CARD_FOUND

La tarjeta ha sido encontrada y anteriormente fue suspendida con el motivo CARD_LOST.

ISSUER_DECISION

El emisor ha decidido reanudar la tarjeta.

USER_DECISION

El usuario final ha decidido reanudar la tarjeta y la tarjeta fue suspendida previamente con USER_DECISION.

Motivos de eliminación

Motivo
Descripción

CLOSED_ACCOUNT

El usuario final ha cerrado la cuenta y la tarjeta debe ser eliminada/cancelada.

CLOSED_CARD

La tarjeta debe ser eliminada/cancelada.

CARD_LOST

La tarjeta ha sido reportada como perdida y debe ser eliminada/cancelada.

CARD_STOLEN

La tarjeta ha sido reportada como robada y debe ser eliminada/cancelada.

CARD_BROKEN

La tarjeta está dañada y debe ser eliminada/cancelada.

FRAUD

La tarjeta está comprometida y debe ser eliminada/cancelada.

USER_DECISION

El usuario final ha decidido eliminar la tarjeta.

ISSUER_DECISION

El emisor ha decidido eliminar la tarjeta.

Motivos de reemplazo

Motivo
Descripción

CARD_LOST

La tarjeta ha sido reportada como perdida.

CARD_STOLEN

La tarjeta ha sido reportada como robada.

CARD_BROKEN

La tarjeta está dañada y ya no funciona.

FRAUD

La tarjeta está comprometida.

ISSUER_DECISION

El emisor ha decidido reemplazar la tarjeta.

Motivos de renovación

Motivo
Descripción

USER_DECISION

El usuario final ha decidido renovar la tarjeta.

ISSUER_DECISION

El emisor ha decidido renovar la tarjeta.

CARD_EXPIRED

La tarjeta ha sido renovada porque ha expirado o está a punto de expirar.

Operaciones de la API de D1

Use estos endpoints de la API de D1 para las operaciones del ciclo de vida:

Puede recuperar la lista de tarjetas usando Obtener la lista de tarjetas.

Si necesita los detalles de la tarjeta, use Obtener detalles de la tarjeta.

Flujos de renovación y reemplazo

Renovación automática

La renovación automática solo está disponible para tarjetas creadas con D1.

D1 supervisa las fechas de vencimiento de las tarjetas y puede activar la renovación unas semanas antes de la expiración.

Renovación manual

La renovación manual está disponible para tarjetas creadas con D1 y para tarjetas registradas.

Active la renovación manual usando el Renovar una tarjeta endpoint.

Si la tarjeta está registrada (no creada con D1), proporcione el nuevo PAN y/o la fecha de expiración para que D1 se mantenga actualizado.

Flujo de reemplazo manual

El reemplazo manual está disponible para tarjetas creadas con D1 y para tarjetas registradas.

Active el reemplazo manual usando el Reemplazar una tarjeta endpoint.

Si la tarjeta está registrada (no creada con D1), proporcione el nuevo PAN y/o la fecha de expiración para que D1 se mantenga actualizado.

Activación de la nueva tarjeta

Dependiendo de la configuración de su producto de tarjeta, después de la renovación o el reemplazo la nueva tarjeta puede crearse en el estado INACTIVE .

Hay tres formas de activar la tarjeta:

  • Activación en la primera transacción con tarjeta presente y con un PIN válido (solo tarjetas creadas mediante D1).

  • Activación manual usando la API de D1 (todavía no disponible).

  • Activación manual desde la aplicación del emisor usando el SDK de D1 (todavía no disponible).

Última actualización

¿Te fue útil?