Reimpresión y reposición de tarjetas

Reemplaza el plástico de tus clientes por deterioro, robo o pérdida sin interrumpir su operatoria.

Introducción

Cuando el plástico de tu cliente se daña o se desgasta, la alternativa tradicional es emitir una tarjeta nueva con un número diferente. Eso lo obliga a volver a vincular la tarjeta en cada servicio donde la tenía registrada: suscripciones, billeteras digitales, domiciliaciones. Es una fricción que puedes evitar.

Con la reimpresión, tu cliente recibe un plástico nuevo en su domicilio conservando exactamente el mismo número de tarjeta, PIN, CVV y fecha de vencimiento. Su historial transaccional se mantiene intacto, sin ningún corte ni migración de datos. Lo único que cambia es un identificador interno del plástico (el PSN, o PAN Sequence Number), que usamos para distinguir el nuevo del anterior en el sistema transaccional, pero que no es visible ni relevante para tu cliente.

Todo el proceso es transparente para tu cliente: recibe el plástico nuevo, lo activa con un código de activación y desactivamos el anterior automáticamente. No tiene que hacer ningún trámite adicional ni volver a cargar sus datos en ningún lado.

Cuando el motivo es un robo o una pérdida, el reemplazo funciona distinto. Ahí no puedes conservar los datos de la tarjeta comprometida, así que bloqueamos la anterior y emitimos una con datos nuevos. A ese caso lo llamamos reposición.

Reimpresión, reposición y renovación: cuál corresponde

Criterio	Reimpresión	Reposición	Renovación
Motivo	Deterioro o daño físico.	Robo o pérdida.	Próxima a vencer o vencida.
PAN	Lo mantenemos.	Lo cambiamos.	Lo cambiamos.
CVV y fecha de expiración	Los mantenemos.	Los cambiamos.	Los cambiamos.
PIN	Lo mantenemos.	Tu cliente lo vuelve a definir.	Tu cliente lo vuelve a definir.
Cuándo deja de operar la tarjeta anterior	Cuando tu cliente activa la nueva.	Al confirmar la solicitud.	Cuando tu cliente activa la nueva o cuando vence, lo que ocurra primero.
Tipo de tarjeta	Solo físicas nominadas.	Físicas y virtuales.	Físicas y virtuales.

Si tu cliente reporta un robo o una pérdida, usa siempre la reposición. La reimpresión conserva el PAN original, por lo que no resuelve una tarjeta comprometida.

Cuándo no corresponde una reimpresión

Situación	Qué corresponde
Tu cliente reporta robo o pérdida	Reposición. La reimpresión conserva el PAN comprometido.
La tarjeta está próxima a vencer o ya venció	Renovación. Incluye el ID de la tarjeta en la solicitud de renovaciones.
La tarjeta es virtual	Reposición. No hay plástico que reemplazar.
La tarjeta es física innominada	Ninguna de las dos. Las innominadas no son elegibles.

Alcance

Criterio	Condiciones
Tipo de tarjeta	Reimpresión: solo tarjetas físicas nominadas. Reposición: tarjetas físicas y virtuales.
Estado requerido	La tarjeta debe estar `ACTIVE`.
Motivos habilitados	Deterioro (`WORN`) o daño físico (`DAMAGED`) para la reimpresión. Robo o pérdida para la reposición.
Países disponibles	Para reimpresión contacta a nuestro equipo para evaluar disponibilidad, reposición está habilitado para todos los países donde opera Pomelo.
Múltiples reimpresiones	Sí, con un período mínimo de espera de 30 días por defecto entre una reimpresión y la siguiente sobre la misma tarjeta. Ese período es configurable.
Método de entrega	Puedes usar el domicilio de la última entrega o registrar uno nuevo al cargar la solicitud desde el Dashboard. Si no tienes contratado nuestro servicio de Shipping, no te solicitamos este dato.

Funcionamiento

Puedes cargar la solicitud desde el Dashboard, sin integración técnica, o desde tu backend con la API. En el Dashboard las dos acciones viven en el mismo lugar: desde el detalle de la tarjeta, en el menú "Otras acciones" tienes la opción "Reemitir".

El plástico nuevo conserva el PAN, el CVV y la fecha de expiración. La tarjeta original sigue operativa hasta que tu cliente activa la nueva, así que puedes cargar la solicitud sin dejarlo sin operar en el medio.

Solicita un token. Solicita un token de autorización para comunicarte con nuestras APIs siguiendo esta documentación.
Crea la reimpresión. Usa este endpoint y te respondemos con el ID de la tarjeta reimpresa. Validamos la elegibilidad en la misma llamada: si la tarjeta no cumple alguna condición, rechazamos la solicitud y te devolvemos el motivo.
Indica el motivo. Completa el campo reason con WORN (deterioro) o DAMAGED (daño físico).
Carga los datos del envío. Completa el domicilio de entrega en address y los datos de quien recibe en receiver.
Sigue el estado. Consulta el estado de la reimpresión o espera los eventos REPRINT_CREATION y REPRINT_ACTIVATION en el webhook de eventos de tarjetas.

Bloqueamos la tarjeta anterior al confirmar la solicitud y emitimos una con PAN, CVV y fecha de expiración nuevos. Tu cliente tiene que volver a tokenizar la tarjeta y actualizar sus pagos recurrentes.

Deshabilita la tarjeta anterior. Actualiza el estado de la tarjeta con status igual a DISABLED y status_reason igual a LOST o STOLEN, según corresponda. De esta manera, la tarjeta comprometida deja de operar. Cuando se completa la actualización, te notificamos mediante el evento DISABLEMENT.
Crea la tarjeta de reposición. Luego, crea una nueva tarjeta y completa previous_card_id con el ID de la tarjeta que acabas de deshabilitar. Emitimos una nueva tarjeta con datos diferentes y la vinculamos con la anterior.

El orden es obligatorio: primero debes deshabilitar la tarjeta anterior y después crear la reposición. Si envías previous_card_id antes de que la tarjeta esté DISABLED, rechazamos la solicitud con el error INVALID_PREVIOUS_STATUS_CARD.

Preguntas frecuentes

¿El número de tarjeta, el PIN, el CVV o la fecha de vencimiento cambian con la reimpresión?

No. El nuevo plástico conserva exactamente los mismos datos que el original. Lo único que cambia es el PSN, un identificador interno que no es visible para tu cliente.

¿El cliente puede seguir usando la tarjeta original mientras espera la reimpresión?

Sí. El plástico original permanece ACTIVE durante toda la fabricación y el envío. Solo lo desactivamos en el momento en que tu cliente activa el nuevo plástico. No existe un período de gracia en el que ambos plásticos estén activos al mismo tiempo.

¿Qué pasa si el cliente no activa el nuevo plástico?

La reimpresión queda pendiente de forma indefinida y el plástico original sigue activo. Por el momento no hay una fecha de expiración automática para la reimpresión.

¿Se puede reimprimir una tarjeta más de una vez?

Sí, con un período mínimo de espera de 30 días por defecto entre una reimpresión y la siguiente sobre la misma tarjeta. Ese período es configurable: contáctanos si necesitas cambiarlo.

¿Se puede reimprimir una tarjeta virtual?

No. La reimpresión está disponible únicamente para tarjetas físicas nominadas que estén ACTIVE. En una tarjeta virtual la única acción disponible es la reposición.

¿Qué pasa con los tokens de pago de mi cliente?

En una reimpresión los mantenemos, porque el PAN no cambia. En una reposición por robo o pérdida tu cliente tiene que volver a tokenizar la tarjeta en cada billetera donde la tenía registrada.

¿Cómo distingo si una activación corresponde a una reimpresión o a una activación nueva?

Lo marcamos automáticamente. Si te integras vía API, recibes el evento REPRINT_ACTIVATION en lugar de ACTIVATION, con el related_card_id de la tarjeta original.

¿Qué pasa si falla la solicitud de reimpresión?

Te devolvemos el motivo del fallo. Desde el Dashboard permaneces en la pantalla de resumen para reintentar. Vía API te respondemos con el error correspondiente cuando la tarjeta no es elegible: encuentra el detalle en Crear Reimpresión de Tarjeta.

¿Se puede revertir una reposición por robo o pérdida?

No. Al confirmar la reposición bloqueamos la tarjeta anterior de forma definitiva y emitimos una nueva con datos distintos.