Configuraciones de uso de las tarjetas
Elige los canales habilitados por tarjeta para ofrecer experiencias diferenciadas sin afectar a todo el grupo de afinidad.
Introducción
Los servicios de uso de cada tarjeta se definen a nivel grupo de afinidad (AFG): todas las tarjetas del grupo heredan las mismas reglas de habilitación. Sin embargo, hay situaciones donde necesitas más granularidad (ya sea por perfil de cliente, casos sensibles o estrategias de riesgo).
Con la funcionalidad de “Configuraciones de la tarjeta” podrás definir los canales habilitados por tarjeta de forma individual, sin modificar la configuración del resto del grupo de afinidad. Esto te permite ofrecer experiencias diferenciadas, gestionar casos sensibles y operar con mayor control en tus estrategias de riesgo y seguridad.
Alcance
Esta funcionalidad está disponible para todos los países donde operamos.
Canales configurables
| Canal | Descripción |
|---|---|
| ATM | Retiros de dinero en efectivo |
| POS | Compras con tarjeta presente |
| E-commerce | Compras en línea |
| Extracash | Extracción de efectivo en comercios |
Cada canal es configurable de forma independiente para operaciones domésticas e internacionales.
Funcionamiento
El grupo de afinidad actúa como capa padre: define el máximo de canales permitidos para todas las tarjetas del grupo. La tarjeta hereda automáticamente esa configuración y solo puede aplicar restricciones adicionales (nunca habilitaciones que el grupo de afinidad no permita).
| Configuración AFG | Configuración tarjeta | Resultado |
|---|---|---|
| ATM habilitado | ATM deshabilitado | ✅ Válido (más restrictivo) |
| ATM habilitado | ATM habilitado | ✅ Válido (mismo nivel) |
| ATM deshabilitado | ATM habilitado | ❌ No permitido |
Implementación
Editar la configuración de una tarjeta
Usa update_card para modificar la configuración de canales de una tarjeta ya emitida. Solo procesamos los campos que envías (partial update).
Consultar la configuración actual
El endpoint GET /cards/{card_id} retorna el nodo optional_services con la configuración activa de la tarjeta.
Comportamiento en autorización
Cuando tu cliente intenta realizar una transacción en un canal deshabilitado, la rechazamos al inicio del flujo de autorización — antes de CVM/PIN, saldo, límites y motor de antifraude.
| Campo | Valor |
|---|---|
| Código de rechazo a la marca | RC57 – Transaction Not Permitted |
status_detail | transaction_not_permitted |
extra_detail | rechazado por servicio opcional apagado |
Gestión desde el Dashboard
Desde el detalle de cada tarjeta en el Dashboard puedes:
- Editar las condiciones de uso en cualquier momento. Los canales que difieren del grupo de afinidad se identifican con la leyenda "Distinto al AFG". El cambio tiene impacto inmediato en el autorizador.
- Identificar tarjetas con condiciones especiales mediante un banner en el detalle de la tarjeta.
- Restablecer la herencia del AFG, eliminando todas las configuraciones individuales de la tarjeta.
Preguntas frecuentes
¿Cómo activo la funcionalidad Servicios Opcionales?
Contáctanos desde el Dashboard.
¿Puedo configurar canales distintos para operaciones domésticas e internacionales?
Sí. La configuración se define por separado para operaciones domésticas e internacionales, con control independiente por canal.
¿Qué pasa si el usuario intenta operar en un canal deshabilitado?
Rechazamos la transacción con RC57 – Transaction Not Permitted. El status_detail indica que el rechazo corresponde a una configuración de condiciones de uso.
¿La configuración por tarjeta puede superar los permisos del grupo de afinidad?
No. La tarjeta solo puede aplicar restricciones adicionales. No es posible habilitar un canal que el AFG tenga bloqueado.
¿Qué ocurre si el grupo de afinidad cambia mientras la tarjeta ya tiene configuración individual?
La tarjeta conserva su configuración. Si deshabilitas un canal en el AFG, rechazaremos las transacciones. Si lo vuelves a habilitar, la tarjeta retoma su operatoria sin necesidad de realizar cambios adicionales.
¿Cómo veo la configuración activa de una tarjeta?
Vía API, el endpoint GET /cards/{card_id} retorna el nodo optional_services con el estado actual de cada canal. También puedes consultarlo desde el Dashboard ingresando al detalle de la tarjeta.