Gestionar fallos de alta

La inscripción puede fallar después de que el usuario final comience a aprovisionar una tarjeta.

Cuando esto ocurre, el solicitante del token (proveedor de monedero) o la red de pago TSP puede eliminar el token.

Lo que recibe el backend del emisor

El Servicio de Tokenización notifica al backend del emisor usando notifyVirtualCardChange.

Para fallos de inscripción que resultan en la eliminación del token, acción es típicamente:

• ELIMINAR (token eliminado en la red de pago TSP)

• ELIMINAR_DE_LA_APP (token eliminado en la aplicación del monedero, MDES solo)

notifyVirtualCardChange también incluye:

• x-correlation-id (encabezado HTTP) para vincular la sesión de inscripción.

• virtualCardId y issuerCardRefId para identificar el token y la tarjeta.

• origen para indicar quién inició el cambio (MONEDERO, TSP, o EMISOR).

Ejemplo de cuerpo de solicitud (simplificado)

{
  "issuerCardRefId": "string",
  "virtualCardId": "string",
  "walletProviderId": "APPLE_PAY",
  "isPrimary": true,
  "action": "DELETE",
  "source": "TSP"
}

Cómo manejar los fallos de inscripción

Manejar notifyVirtualCardChange de forma idempotente. Puede recibir duplicados o callbacks tardíos.

Cuando acción indica eliminación:

1. Marcar el token como eliminado en el backend del emisor.

2. Detener cualquier autenticación de escalado pendiente para esta inscripción.

3. Permitir que el usuario final reinicie la inscripción.

notifyVirtualCardChange se utiliza para más que fallos de inscripción. También se usa para cambios de estado como ACTIVAR, SUSPENDER, y REANUDAR.

Documentación relacionada

• Actualización del estado del token por el monedero

• Saliente (hacia el emisor)