Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Gestionar el ciclo de vida de las tarjetas

Ciclo de vida y operaciones de la tarjeta

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

Diagrama de 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 las operaciones 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 declarada perdida. Puede: - reanudar la tarjeta usando el motivo CARD_FOUND. - solicitar un reemplazo.

CARD_STOLEN

La tarjeta ha sido declarada 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 estaba suspendida previamente 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 estaba 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 eliminarse/cancelarse.

CLOSED_CARD

La tarjeta debe eliminarse/cancelarse.

CARD_LOST

La tarjeta ha sido declarada perdida y debe eliminarse/cancelarse.

CARD_STOLEN

La tarjeta ha sido declarada robada y debe eliminarse/cancelarse.

CARD_BROKEN

La tarjeta está dañada y debe eliminarse/cancelarse.

FRAUD

La tarjeta está comprometida y debe eliminarse/cancelarse.

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 declarada perdida.

CARD_STOLEN

La tarjeta ha sido declarada 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

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

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

Si necesita 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 del vencimiento.

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 nueva fecha de vencimiento 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 nueva fecha de vencimiento para que D1 se mantenga actualizado.

Activación de la nueva tarjeta

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

Hay tres formas de activar la tarjeta:

  • Activación en la primera transacción con tarjeta presente y PIN válido (solo para tarjetas creadas a través de D1).

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

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

Última actualización

¿Te fue útil?