Renovación automática de tarjetas

Mantén a tus clientes activos con nuevas tarjetas antes de que venzan las anteriores, sin interrupciones en el servicio.

Introducción

Cuando una tarjeta vence sin ser reemplazada, tu usuario final pierde acceso a sus pagos. Esto genera tickets de soporte, transacciones rechazadas y riesgo de churn para tu negocio.

Con la renovación automática de tarjetas resolvemos estos problemas: detectamos proactivamente las tarjetas próximas a vencer y generamos su reemplazo antes de que expiren. El flujo aplica tanto a tarjetas físicas como virtuales, y mantiene la experiencia de tu usuario final sin interrupciones.

Para usar la renovación automática de tarjetas físicas con envío, necesitas tener contratado nuestro servicio de Printing & Logistics.

Alcance

Aplica a tarjetas físicas y virtuales.
Está disponible en todos los países donde operamos.
Ponte en contacto con nosotros para configurar el parámetro de anticipación (cuántos meses antes del vencimiento se dispara la renovación). Por defecto está en 3 meses.

Si utilizas nuestra solución de tokenización, al renovar una tarjeta tokenizada en Ecommerce/Merchants, Apple Pay o Google Pay, actualizaremos la información del token automáticamente sin que tu usuario final deba hacer nada.

Funcionamiento

El flujo de renovación opera a través de un intercambio de archivos CSV entre nuestros sistemas y los tuyos vía SFTP:

Detectamos automáticamente las tarjetas próximas a vencer según el parámetro configurado (por ejemplo, 3 meses antes del vencimiento).
Generamos mensualmente un archivo EXPIRATION_NOTICE con el listado de tarjetas identificadas y te lo compartimos vía SFTP.
Nos devuelves un archivo RENOVATION_REQUEST indicando qué tarjetas quieres renovar y cuáles no, por el mismo canal SFTP.
Generamos una nueva tarjeta con datos actualizados (nuevo PAN, CVV y fecha de vencimiento) y un nuevo crd_id. Conservamos la configuración del producto, los límites y la relación con el titular.
Mantenemos la tarjeta anterior activa hasta que tu usuario active la nueva o hasta que expire. Una vez activada la nueva, damos de baja automáticamente la anterior.
El usuario activa la nueva tarjeta mediante el flujo de activación existente, vía API.
Te enviamos un archivo RENOVATION_RESULT con el resultado de cada renovación solicitada.

Formato de archivos

El intercambio opera con tres archivos CSV a través de SFTP:

👉 EXPIRATION_NOTICE (de nosotros hacia ti)

Archivo que te enviamos con las tarjetas próximas a vencer.

Campo	Tipo	Req.	Descripción
card_id	string	Sí	Identificador de la tarjeta próxima a vencer

👉 RENOVATION_REQUEST (de ti hacia Pomelo)

Tu respuesta indicando qué tarjetas quieres renovar. Si tienes contratado el servicio de Printing & Logistics, puedes incluir la dirección de envío en este archivo; si la omites, usamos la registrada previamente. Si no tienes contratado el servicio, los campos de dirección no aplican.

Campo	Tipo	Req.	Descripción
card_id	string	Sí	ID de la tarjeta (debe coincidir con el `EXPIRATION_NOTICE`)
renovate	boolean	Sí	`true` para renovar, `false` para omitir
street_name	string	No	Dirección de envío — calle. Solo aplica con Printing & Logistics contratado.
street_number	string	No	Dirección de envío — número. Solo aplica con Printing & Logistics contratado.
floor	string	No	Dirección de envío — piso. Solo aplica con Printing & Logistics contratado.
apartment	string	No	Dirección de envío — departamento. Solo aplica con Printing & Logistics contratado.
city	string	No	Dirección de envío — ciudad. Solo aplica con Printing & Logistics contratado.
region	string	No	Dirección de envío — provincia / estado. Solo aplica con Printing & Logistics contratado.
country	string	No	Dirección de envío — país. Solo aplica con Printing & Logistics contratado.
zip_code	string	No	Dirección de envío — código postal. Solo aplica con Printing & Logistics contratado.
neighborhood	string	No	Dirección de envío — barrio. Solo aplica con Printing & Logistics contratado.
additional_info	string	No	Instrucciones adicionales de entrega. Solo aplica con Printing & Logistics contratado.

👉 RENOVATION_RESULT (de nosotros hacia ti)

Confirmación del resultado de cada renovación solicitada.

Campo	Tipo	Req.	Descripción
card_id	string	Sí	ID de la tarjeta del request original
outcome	string	Sí	Resultado: `RENOVATED`, `NOT_RENOVATED` o `FAILED`
new_card_id	string	No	ID de la nueva tarjeta (solo cuando `outcome` es `RENOVATED`)

Flujo por tipo de tarjeta

Tipo	Generación	Envío	Activación
Física	Nuevo PAN, CVV y fecha de vencimiento	La enviamos a impresión y logística según la dirección indicada en el `RENOVATION_REQUEST` o la registrada previamente	Manual, por el usuario final vía API
Virtual	Nuevo PAN, CVV y fecha de vencimiento	No aplica	Automática tras la generación
Tokenizada	Nuevo PAN, CVV y fecha de vencimiento	No aplica	Actualizamos automáticamente los tokens en las wallets

Estados y notificaciones

La renovación no genera nuevos estados ni eventos en las tarjetas. Usamos los mismos webhooks de estado de tarjeta existentes, con un REASON = RENOVATION que identifica que el cambio se originó por una renovación. Esto aplica tanto a la creación de la nueva tarjeta como a la baja de la anterior.

Visualización en el Dashboard

En el Dashboard ves el estado de cada tarjeta a lo largo del proceso de renovación mediante alertas y etiquetas en el detalle de tarjeta:

Visualización en Dashboard

Estado	Qué ves como emisor
Próxima a vencer	Alerta naranja con la indicación de incluir el ID en la solicitud de renovación.
En proceso de renovación	Alerta naranja indicando que el reemplazo está siendo preparado. La tarjeta anterior sigue operativa.
Vencida (reemplazada)	Alerta roja con acceso directo a la nueva tarjeta activa.
Nueva tarjeta	Alerta azul indicando que reemplaza a una tarjeta vencida o por vencer, con acceso directo a la anterior.
Vencida sin renovación	Alerta roja indicando que la tarjeta no fue seleccionada para renovación. Para renovarla, se debe incluir el card ID en el próximo CSV de confirmación que se envíe vía SFTP.

El historial de transacciones de la tarjeta anterior se conserva y sigue siendo accesible en el Dashboard después de la renovación.

Preguntas frecuentes

¿Qué pasa si el usuario no activa la nueva tarjeta antes de que venza la anterior?

La tarjeta anterior pasa a estado EXPIRED una vez que supera la fecha de expiración, y la tarjeta nueva queda en estado EMBOSSED hasta que tu usuario la active.

¿La tarjeta anterior puede seguir recibiendo presentaciones y ajustes después de ser reemplazada?

Sí. La tarjeta anterior queda en estado EXPIRED, pero sigue procesando las presentaciones y ajustes que le lleguen. Su historial se mantiene intacto.

¿Qué pasa con las tarjetas adicionales (suplementarias) cuando se renueva la tarjeta titular?

Las tarjetas adicionales mantienen su vínculo con la nueva tarjeta titular de forma automática. Pomelo actualiza el parent_id como parte del proceso de renovación, sin intervención requerida por parte del emisor.

¿Puedo configurar el parámetro de anticipación desde el Dashboard?

Todavía no. Para hacerlo, ponte en contacto con nosotros.

¿Cómo se determina la dirección de envío para tarjetas físicas renovadas?

La dirección de envío es la que indicas en el archivo RENOVATION_REQUEST. Si no incluyes una dirección, usamos la registrada previamente en el sistema.

¿La tarjeta se renueva con el mismo grupo de afinidad (AFG)?

Sí. La tarjeta renovada hereda automáticamente el grupo de afinidad de la tarjeta original. No se requiere ninguna acción adicional por parte del emisor.