Sustituir o renovar una tarjeta

Cuando se reemplaza una tarjeta física (por ejemplo, después de una pérdida) o se renueva (por vencimiento), el backend del emisor debe enviar el FPAN actualizado y la fecha de vencimiento al Servicio de Tokenización. El Servicio de Tokenización luego actualiza la información de la tarjeta de financiamiento con el TSP de la red de pago.

Use el API UpdateCard. Proporcione tanto el FPAN y la fecha de vencimiento antiguos como los nuevos.

Actualizar FPAN y fecha de vencimiento

Aquí hay un ejemplo de una solicitud válida:

{
  "issuerCardRefId": "string",
  "fpanDetails": "string (base64)"
}

fpanDetails contiene el FPAN antiguo y nuevo y la fecha de vencimiento cifrados. Es una carga JSON cifrada PKCS#7 codificada en base64.

Formato de la carga JSON:

{
  "oldFPAN": "[0-9]{16,19}",
  "oldExpDate": "MMYY",
  "newFPAN": "[0-9]{16,19}",
  "newExpDate": "MMYY"
}

Algunas redes de pago requieren el FPAN antiguo y la fecha de vencimiento para procesar la actualización.

El flujo detallado:

Flujo UpdateCard para reemplazo o renovación de tarjeta.

Actualizar el perfil de la tarjeta al renovar

En casos poco frecuentes, la tarjeta se renueva porque el usuario final cambia de programa de tarjeta (por ejemplo, de Clásica a Oro).

En este caso, también puede actualizar el perfil de la tarjeta usando newProductId. Este valor es el ID de perfil de tarjeta configurado en el TSP de la red de pago.

Ejemplo de cuerpo de la solicitud:

{
  "issuerCardRefId": "string",
  "fpanDetails": "string (base64)",
  "newProductId": "string"
}

Actualizar issuerCardRefId

issuerCardRefId identifica de forma única la tarjeta. También puede actualizarlo durante este proceso usando newIssuerCardRefId.

Ejemplo de cuerpo de la solicitud:

{
  "issuerCardRefId": "string",
  "fpanDetails": "string (base64)",
  "newProductId": "string",
  "newIssuerCardRefId": "string"
}