Reporte maestro de tarjetas
Mantén tu base de tarjetas sincronizada con un archivo diario de novedades..
Introducción
Cada vez que una de tus tarjetas se crea, se activa, se bloquea o se reemplaza, ese cambio queda registrado en Pomelo y te lo informamos a través de las notificaciones de eventos de tarjetas.
Como complemento, te enviamos un archivo diario con todas las tarjetas que tuvieron novedades el día anterior, para que puedas conciliar la información.
Con este reporte puedes:
- Identificar altas, activaciones, bloqueos y bajas del día anterior.
- Ver qué servicios opcionales tiene habilitados cada tarjeta.
Funcionamiento
- Todos los días generamos un archivo con las tarjetas que tuvieron novedades el día anterior (en horario UTC).
- Dejamos el archivo disponible en la carpeta
/cardsde tu SFTP.
Consideraciones:
El archivo es incremental: solo trae las tarjetas cuyo CARD_UPDATED_AT cae dentro del día procesado. Si una tarjeta no tuvo cambios, no aparece en el archivo de ese día.
Cada tarjeta aparece una sola vez por archivo, con su estado vigente al momento de generar el archivo. Si cambió de estado varias veces, solo verás el último.
Estructura del archivo
- Nombre del archivo:
cards_master_{YYYY-MM-DD}_tunombre_tupais.csv, donde la fecha corresponde al día de las novedades informadas - Ubicación:
/cardsde tu SFTP - Disponibilidad: diaria, con los datos del día anterior.
- Formato: CSV separado por punto y coma (
;), con encabezado y codificación UTF-8 - Fechas: ISO 8601 en UTC, con milisegundos
- Campos vacíos: cadena vacía entre separadores
Campos del archivo
| Campo | Descripción | Ejemplo |
|---|---|---|
| AFFINITY_GROUP_NAME | Nombre del grupo de afinidad al que pertenece la tarjeta. | Tarjeta Gold Mastercard |
| AFFINITY_GROUP_ID | Identificador del grupo de afinidad. | afg-XXXXXX |
| PRODUCT_PROVIDER | Marca de la tarjeta (VISA, MASTERCARD). | MASTERCARD |
| PRODUCT_TYPE | Tipo de producto (PREPAID, CREDIT, DEBIT). | CREDIT |
| BIN | BIN bajo el cual se emitió la tarjeta. Puede tener 6 u 8 dígitos. | 52103300 |
| CARD_ID | Identificador único de la tarjeta. Úsalo como clave para actualizar tu base. | crd-XXXXXX |
| LAST_FOUR | Últimos cuatro dígitos de la tarjeta. Nunca enviamos el número completo. | 5947 |
| CARD_TYPE | Tipo de tarjeta (PHYSICAL, VIRTUAL). | PHYSICAL |
| NAME_ON_CARD | Nombre impreso en la tarjeta. Puede venir abreviado. | CAMILA GOMEZ |
| CARD_CREATED_AT | Fecha y hora de creación de la tarjeta. | 2026-10-11T12:52:17.906Z |
| CARD_ACTIVATED_AT | Fecha y hora de activación de la tarjeta. Vacío si la tarjeta no registra activación. Las tarjetas virtuales nacen activas. | 2026-10-25T03:10:19.348Z |
| CARD_UPDATED_AT | Fecha y hora de la última modificación de la tarjeta. Define en qué archivo aparece el registro. | 2026-10-29T02:32:50.464Z |
| PREVIOUS_CARD_ID | Identificador de la tarjeta a la que reemplaza, en renovaciones, reposiciones o upgrades. Vacío si no reemplaza a ninguna. | crd-XXXXXX |
| SHIPMENT_ID | Identificador del envío. Solo aplica a tarjetas físicas con envío generado; vacío en tarjetas virtuales. | shi-XXXXXX |
| EMBOSSED_AT | Fecha y hora de embozado. Solo aplica a tarjetas físicas ya embozadas; vacío en tarjetas virtuales. | 2026-10-15T17:24:46.602Z |
| STATUS | Estado de la tarjeta al cierre del día. | ACTIVE |
| STATUS_DETAIL | Motivo del estado actual, cuando aplica. | CLIENT_INTERNAL_REASON |
| CARD_STATUS_UPDATED_AT | Fecha y hora del último cambio de estado. | 2026-10-29T02:32:50.464Z |
| USER_ID | Identificador del titular de la tarjeta. Un mismo titular puede tener varias tarjetas. | usr-XXXXXX |
| USER_NAME | Nombre del titular. | Camila |
| USER_SURNAME | Apellido del titular. | Gomez |
| USER_IDENTIFICATION_TYPE | Tipo de documento de identidad de tu cliente. Depende del país (por ejemplo, DNI, CE, CC, CI, PASSPORT). | DNI |
| USER_IDENTIFICATION_VALUE | Número de documento de identidad de tu cliente, sin puntos ni guiones. | 28343522 |
| COMPANY_ID | Identificador de la compañía a la que pertenece la tarjeta. Solo aplica a tarjetas corporativas; vacío en tarjetas personales. | cmp-XXXXXX |
| HAS_OPTIONAL_SERVICES | true si la tarjeta tiene una configuración propia de servicios opcionales. Si es false, los ocho campos siguientes llegan vacíos y aplican las reglas por defecto del producto. | true |
| INTERNATIONAL_ECOMMERCE | true si la tarjeta tiene habilitadas las compras online internacionales. | true |
| INTERNATIONAL_EXTRACASH | true si la tarjeta tiene habilitado el extracash internacional. | false |
| INTERNATIONAL_PURCHASES | true si la tarjeta tiene habilitadas las compras presenciales internacionales. | true |
| INTERNATIONAL_WITHDRAWAL | true si la tarjeta tiene habilitada la extracción de efectivo internacional. | false |
| LOCAL_ECOMMERCE | true si la tarjeta tiene habilitadas las compras online locales. | true |
| LOCAL_EXTRACASH | true si la tarjeta tiene habilitado el extracash local. | true |
| LOCAL_PURCHASES | true si la tarjeta tiene habilitadas las compras presenciales locales. | true |
| LOCAL_WITHDRAWAL | true si la tarjeta tiene habilitada la extracción de efectivo local. | false |
Preguntas frecuentes
¿El archivo trae todas mis tarjetas?
No. Solo trae las tarjetas que tuvieron novedades el día anterior.
¿Cómo identifico una renovación, reposición o upgrade?
La tarjeta nueva llega con PREVIOUS_CARD_ID completo, apuntando a la tarjeta que reemplaza. La tarjeta anterior llega con estado DISABLED.
¿Por qué los servicios opcionales vienen vacíos en algunas tarjetas?
Porque esas tarjetas no tienen una configuración propia de servicios opcionales. En ese caso, HAS_OPTIONAL_SERVICES es false y aplican las reglas por defecto del producto.
¿Las fechas están en mi hora local?
No. Todas las fechas están en UTC.