Esta funcionalidad se habilita a pedido. Para usarla, contáctanos desde el Dashboard.

Tarjeta Combo

Ofrece crédito y débito en una única tarjeta para tus clientes.

Introducción

La Tarjeta Combo te permite emitir un único PAN (número de tarjeta) con dos funciones independientes: crédito y débito (o prepago). El titular selecciona la función deseada en el punto de venta y enrutamos automáticamente la transacción al ledger correspondiente.

A diferencia de las tarjetas multi-app, que tienen dos PANes (uno por función), la Tarjeta Combo usa un único número de tarjeta para ambas funciones.

Alcance

Tema	Detalle
Disponibilidad	🇧🇷 Brasil
Marca	Mastercard
Funciones disponibles	Crédito + Débito / Crédito + Prepago
Funciones dormidas	Sí (configurable por producto/BIN y por tarjeta individual)

Configuración de funciones activas

Puedes controlar qué funciones están disponibles en dos niveles: la configuración predeterminada del producto/BIN y el override individual por tarjeta.

Por producto / BIN (configuración predeterminada)

Para definir qué funciones nacen activas, coordina con nuestro equipo de Integraciones. Las opciones disponibles son:

Configuración	Comportamiento
Crédito y débito	Ambas funciones nacen activas. El titular puede usar crédito o débito desde el primer día.
Solo crédito	La función débito nace dormida. Puede activarse después por tarjeta o en batch (próximamente).
Solo débito / prepago	La función crédito nace dormida. Puede activarse después por tarjeta o en batch (próximamente).

Los cambios en la configuración del producto aplican únicamente a tarjetas nuevas. Las tarjetas ya emitidas mantienen la configuración del momento de su creación.

Por tarjeta (override individual)

Para activar una función dormida en una tarjeta específica, usa el endpoint de actualización de tarjeta:

El GET /cards devuelve las funciones actualmente activas de cada tarjeta:

Para clientes sin Tarjeta Combo, no devolvemos el campo subtypes_active.

Comportamiento cuando la función está dormida

Si el titular intenta usar una función que aún no está activa, rechazamos la transacción con la siguiente respuesta:

Campo	Valor
`status_detail`	`transaction_not_permitted`
`extra_detail` (función crédito dormida)	`Credit function not active yet`
`extra_detail` (función débito dormida)	`Debit function not active yet`
`extra_detail` (función prepago dormida)	`Prepaid function not active yet`

Si llega una presentación de clearing para una función dormida, procesamos el ajuste de todas formas. Por eso, es importante que configures ambos endpoints (crédito y débito) antes de emitir tarjetas combo.

Reflejo en la transacción

Cada transacción de Tarjeta Combo incluye el campo product_subtype, que indica con qué función se realizó la operación:

Campo	Tipo	Valores	Descripción
`product_subtype`	string	`CREDIT` / `DEBIT` / `PREPAID`	Función utilizada en la operación.

El campo está disponible en:

Webhooks de transacciones aprobadas y rechazadas
Webhooks de presentaciones (clearing)
Ajustes
Request enviado a tu endpoint de autorización
Reportes transaccionales
Detalle de la transacción vía Dashboard

Ejemplo de payload

Para transacciones de tarjetas no-combo, el campo product_subtype llega como null en los webhooks — sin necesidad de cambios en tu integración actual.

Endpoints de autorización

Para la Tarjeta Combo, debes configurar dos endpoints de autorización separados: uno para la función crédito y otro para la función débito/prepago. El enrutamiento es automático según lo que recibimos de la marca.

Endpoint	Transacciones que recibe
Crédito	Compras y devoluciones de la función crédito.
Débito / Prepago	Compras y devoluciones de la función débito o prepago.

Crédito + Prepago

Cuando la combinación de funciones es crédito + prepago, tratamos la función prepago operacionalmente como débito para enrutamiento, mensajería y settlement. El enrutamiento siempre es por función transaccional, no por BIN, por lo que el settlement se dirige al ledger correcto independientemente del BIN de la tarjeta. La distinción entre débito y prepago queda registrada en el campo product_subtype para trazabilidad en tus reportes.

Buenas prácticas de configuración

Usa funciones dormidas para salir al mercado más rápido y activar la segunda función cuando tu infraestructura esté lista.
Configura ambos endpoints (crédito y débito) antes de emitir tarjetas. Las presentaciones de una función dormida llegan por el endpoint correspondiente.
Prueba el flujo de rechazo por función dormida antes del go-live para garantizar la experiencia correcta al titular.
Coordina con el equipo de Integraciones si necesitas cambiar la configuración de funciones por defecto para nuevas tarjetas (los cambios no aplican a tarjetas ya emitidas).
Monitorea el campo product_subtype en los webhooks para segregar métricas de crédito y débito en tu sistema.

Preguntas frecuentes

¿Cómo habilito la Tarjeta Combo?

Contáctanos desde el Dashboard.

¿Un titular puede tener dos tarjetas separadas dentro del mismo producto combo?

No. La Tarjeta Combo usa un único PAN. La diferenciación de función ocurre en el momento de la transacción, no en el plástico.

¿Puedo activar la función dormida para un titular específico?

Sí. Usa PATCH /cards/{card_id} pasando el campo subtypes_active con las funciones que deben estar activas. La activación masiva (batch) estará disponible próximamente.

¿La Tarjeta Combo está disponible para Visa?

No. El soporte inicial es exclusivo para Mastercard.

¿Cómo veo la función utilizada en cada transacción?

El campo product_subtype en el webhook y en el request enviado a tu autorizador indica si la función utilizada fue CREDIT, DEBIT o PREPAID. También puedes revisarlo desde el detalle de la transacción en el Dashboard.

¿El campo product_subtype impacta mi integración actual?

No. Para transacciones de tarjetas "no-combo", el campo llega como null, sin necesidad de cambios en tus sistemas existentes.