Transacciones sin marca

Procesa transacciones directamente sobre las cuentas y tarjetas de tus usuarios sin pasar por redes externas, con control total sobre autorización, clearing y liquidación.

Introducción

Cuando operas como adquirente, enrutar cada transacción por una red externa implica costos de intercambio y menor control sobre la experiencia de tu usuario.
Transacciones sin marca (también conocido como On Us Processing) te permite procesar esas transacciones directamente dentro de Pomelo, actuando como adquirente y emisor al mismo tiempo. Así reduces el costo operativo, aumentas la velocidad de autorización y ganas visibilidad completa sobre el ciclo de vida de cada operación.

Con este módulo puedes autorizar compras, retiros, transferencias entre cuentas, pagos con QR y otros tipos de movimiento, sin que la transacción viaje por Visa o Mastercard.

Alcance

Transacciones sin marca (On Us Processing) está disponible en todos los países donde operamos. En esta versión:

• Solo procesamos transacciones domésticas. Incorporaremos las operaciones internacionales en versiones futuras.
• Admitimos tarjetas virtuales y físicas bajo BIN.
• Tú gestionas los settlements por fuera.
• No soportamos cuotas financiadas por el comercio (Multiclearing).
• Solo soportamos transacciones iniciadas desde una tarjeta. Incorporaremos otros instrumentos (cuenta, línea de crédito, usuario) en versiones futuras.

Cómo funciona

El flujo de una transacción On Us tiene tres etapas:

1. Transacción: tu sistema envía la solicitud a nuestra API actuando como adquirente. Validamos el instrumento, evaluamos las configuraciones de fraude, corremos validaciones y enrutamos la transacción al emisor para la decisión de aprobación o rechazo. En el modelo on-us, emisor y adquirente son el mismo actor: actuamos como el canal que conecta ambos roles y te reenviamos la respuesta.
2. Presentación (clearing): una vez que completaste la transacción del lado adquirente, la registras mediante un segundo llamado a nuestra API de presentaciones. Esto cierra el ciclo, cruza los montos autorizados con los efectivamente procesados y ejecuta ajustes si hay diferencias.
3. Purgado: omitimos automáticamente las autorizaciones que no reciben una presentación dentro del plazo configurado, liberando los fondos retenidos.

Tipos de transacción soportados

Instrumentos de pago

Cada transacción "On Us" requiere identificar el instrumento del usuario. Los tipos disponibles son:

Operaciones disponibles

Puedes consultar la firma completa de cada endpoint en nuestra API Reference de Transacciones sin marca.

Autorizar una transacción

Envía la solicitud de autorización indicando el tipo de transacción, el instrumento de pago y los montos. Enrutamos la transacción al emisor y te reenviamos su respuesta. El resultado es sincrónico: APPROVED o REJECTED.

Si rechazamos la transacción, el campo status_detail indica el motivo, por ejemplo INSUFFICIENT_FUNDS o TRANSACTION_NOT_PERMITTED.

Reversar una transacción

Puedes reversar una autorización en dos situaciones:

• Por timeout: si no recibiste respuesta nuestra, puedes reversar usando el external_id que enviaste en la autorización original.
• Por cancelación: si necesitas cancelar el total de una autorización pendiente, puedes reversar por el ID de transacción Pomelo.

Refunds

El flujo de Refund Online en Tiempo Real te permite acreditar al usuario en el momento del refund, sin esperar el clearing. Para identificar la transacción original, esperamos recibir el original_transaction_id; si no lo envías, activamos el flujo de matching para resolverlo. Con esas señales, el emisor decide si aprueba o rechaza en tiempo real.

Si el emisor aprueba, el usuario recibe el crédito de forma inmediata. Cuando llega el clearing, lo conciliamos contra esa acreditación previa sin generar un segundo crédito.

Presentar una transacción (clearing)

Una vez que registres la transacción como completada del lado adquirente, la presentas. Procesamos las presentaciones de forma asíncrona: la API responde con estado PENDING de inmediato, y te notificamos el resultado final por webhook.

Si hay diferencias entre el monto autorizado y el presentado, ajustamos el saldo del usuario automáticamente. Solo soportamos Single Clearing por transacción en esta versión.

Reversar una presentación

Si necesitas anular una presentación ya enviada, puedes hacerlo referenciando el ID de la presentación original.

Ajustes manuales

Puedes aplicar ajustes de débito o crédito sobre autorizaciones On Us en cualquier momento, tanto totales como parciales. Puedes hacer esta operación desde el Dashboard.

Reportes

Generamos dos reportes específicos para On Us, disponibles a día vencido. Puedes recibirlos vía SFTP según la configuración de tu cuenta.

Reporte de transacciones

Nombre del archivo: transaction_YYYY-MM-DD_<cliente>_<pais>.csv

Es el mismo reporte de transacciones que ya recibes para tus operaciones de red. Las transacciones "On Us" aparecen dentro de él identificadas con PRODUCT_PROVIDER = ON_US, por lo que puedes filtrar y consolidar tu operación completa desde una sola fuente.

Reporte de presentaciones

Nombre del archivo: on_us_presentment_YYYY-MM-DD_<cliente>_<pais>.csv

A diferencia del reporte de transacciones, este reporte tiene un schema propio diseñado para el flujo On Us. No incluye columnas de red sin equivalente en operaciones close loop, como INTERCHANGE_FEE, BANKNET_REF_NUMBER o ICA_ACQUIRER. Obtenemos los campos que no viajan en el payload de presentación por join con la transacción original usando ORIGINAL_TRANSACTION_ID.

Webhooks

Recibirás notificaciones para autorizaciones y presentaciones de "On us" en el mismo formato de webhooks que ya usas. El cuerpo incluye el campo instrument con el tipo e ID del instrumento utilizado, manteniendo retrocompatibilidad con los campos existentes.

Preguntas frecuentes

¿On Us aplica a tarjetas físicas y virtuales?

Sí. El módulo soporta ambas modalidades.

¿Las transacciones "On Us" pasan por el motor de fraude?

Sí. Las transacciones sin marca siempre pasan por el módulo de fraude. Las validaciones que se aplican dependen de la configuración que tengas activa dentro del módulo. Si quieres ajustarla, ponte en contacto con nuestro equipo.

¿Qué pasa si no presento una transacción dentro del plazo?

El purgador automático revierte la autorización al vencimiento del plazo configurado, liberando los fondos retenidos.

¿Puedo procesar transacciones internacionales con "On Us"?

No en esta versión. Planificamos incorporar las transacciones internacionales, incluyendo conversión de moneda y cálculo de impuestos, en versiones futuras.

¿Los webhooks son los mismos que ya tengo configurados?

Sí. Reutilizamos los mismos eventos que existen hoy y enriquecemos el cuerpo con el campo instrument y el external_id de la transacción, sin romper los contratos actuales.

¿Las transacciones sin marca soportan cuotas por emisor?

No en esta versión. Planificamos el Multiclearing para una versión futura del módulo.