Autorizador de saldos

Delega en nosotros la autorización de las transacciones de tus tarjetas prepagas y de débito, con el saldo de una cuenta digital.


Introducción

Cada vez que tu cliente usa su tarjeta prepaga o de débito, alguien tiene que verificar en el momento que tiene saldo suficiente y decidir si aprobar o rechazar la transacción. Hacerlo por tu cuenta implica mantener el saldo actualizado, responder cada autorización y llevar el registro de cada movimiento.
En Pomelo, con el Autorizador de saldos gestionamos el saldo de cada tarjeta en una cuenta digital y autorizamos sus transacciones por ti.

Alcance

El Autorizador de saldos está disponible en 🇦🇷 Argentina, 🇧🇷 Brasil, 🇨🇴 Colombia y 🇲🇽 México.

Funcionamiento

Para cada tarjeta, creas una cuenta digital asociada que mantiene el saldo disponible. Cuando llega una transacción, el autorizador verifica el estado de la cuenta, su saldo y sus límites transaccionales, y la aprueba o la rechaza según corresponda.

Creación de la cuenta digital

El primer paso para delegarnos la autorización de las transacciones de una tarjeta es crear su cuenta digital:

  1. Crea el usuario con la API de Users, si todavía no lo hiciste.
  2. Crea la cuenta con la API de Cuentas digitales.
  3. Validamos que el usuario exista y, si todo es correcto, te devolvemos el ID de la cuenta en la respuesta.

Autorizador multimoneda

Puedes crear cuentas en las monedas que quieras. Así, puedes autorizar una compra en cualquiera de esas monedas, siempre que alcance el saldo total.

Configuración inicial

  1. Infórmanos en qué monedas vas a liquidar el settlement con la marca.
  2. Define un orden de prioridad para las monedas que quieres usar al autorizar con saldo. Este orden aplica a todos tus clientes y puedes cambiarlo en cualquier momento contactándonos.
  3. Infórmanos el tipo de cambio que quieres usar para convertir las monedas al evaluar una autorización.

No es obligatorio incluir todas las monedas de liquidación en el orden de prioridad. Si una moneda está disponible para liquidación pero no en el orden de prioridad, solo se usa en transacciones en esa misma moneda. Por ejemplo, si quieres que MXN se use solo en transacciones domésticas, puedes dejarla fuera: solo debitaremos en MXN si la compra es doméstica y tu cliente tiene saldo en esa cuenta.

Cómo autorizamos

Cuando recibimos una solicitud de autorización, verificamos si existe una cuenta en la moneda de la transacción:

  • Si conocemos la moneda de la transacción porque está configurada en la cuenta de tu cliente, intentamos autorizar en esa moneda.
  • Si no la conocemos, usamos la moneda de liquidación que informa la marca en la autorización.
  • Si no hay saldo suficiente en esa moneda, usamos los tipos de cambio que nos informaste para evaluar el saldo de las cuentas en otras monedas, según el orden de prioridad.

Aprobamos la transacción solo si alguna de las cuentas tiene saldo suficiente para cubrir el total de la transacción.

Cómo procesamos las reversas

Ante una reversa, intentamos identificar la transacción que le dio origen:

  • Si la identificamos, acreditamos el monto en la cuenta de la que se debitó la transacción, con el mismo tipo de cambio que usamos entonces.
  • Si no la identificamos, la tratamos como una compra nueva: acreditamos el saldo en la moneda que informa la marca o, si la moneda es desconocida, en la moneda de liquidación.

Si te interesa saber cómo gestionamos los contracargos, visita nuestra sección de Contracargos.

Atributos de la cuenta

Durante su ciclo de vida, la cuenta puede cambiar de estado, ya sea a pedido de tu cliente o para cumplir algún requerimiento regulatorio, de fraude u otro. Todas las cuentas nacen en ACTIVE.

ACTIVEDISABLEDFROZENDELETEDACTIVEFROZENDELETEDACTIVEDISABLEDDELETED
Estado Qué permite
ACTIVE La cuenta tiene transaccionalidad completa: pueden entrar y salir fondos.
FROZEN Pueden entrar fondos, pero no salir. Se usa, por ejemplo, ante un bloqueo preventivo por fraude o un proceso judicial.
DISABLED No pueden entrar ni salir fondos.
DELETED No pueden entrar ni salir fondos. Es un estado terminal: la cuenta ya no puede cambiar de estado. Para eliminarla, su saldo tiene que ser 0.

Puedes cambiar el estado con la API de Cuentas digitales o desde el Dashboard.

Motivos del cambio de estado

Para pasar una cuenta a FROZEN, DISABLED o DELETED, tienes que asignarle un motivo. Estos son los motivos posibles y los estados en los que puedes usar cada uno:

Motivo Descripción FROZEN DISABLED DELETED
LOST Acción preventiva por pérdida del dispositivo. ✅ ✅ —
STOLEN Robo del dispositivo. ✅ ✅ —
FRAUD Sospecha o denuncia de fraude. ✅ ✅ ✅
INHIBITION Inhibición a pedido de una entidad regulada. ✅ ✅ —
SEIZURE Embargo a pedido de una entidad regulada. ✅ ✅ —
USER_REQUESTED Pedido de tu cliente. ✅ ✅ ✅
INTERNAL_REASON Motivos internos tuyos o de Pomelo. ✅ ✅ ✅
OTHER Otros motivos. — — ✅

Preguntas frecuentes

¿El saldo de una cuenta puede quedar negativo?

No. El saldo mínimo es 0 y lo consultamos en cada autorización.

¿Puedo reactivar una cuenta eliminada?

No. DELETED es un estado terminal. Las cuentas en FROZEN o DISABLED, en cambio, pueden volver a cambiar de estado.

¿Puedo ver las transacciones rechazadas?

Sí. Puedes consultarlas con la API de Actividades o desde el Dashboard, junto con las transacciones no procesadas por no cumplir algún requisito.

Pomelo AI

Asistente de inteligencia artificial para consultas sobre la API de Pomelo
¡Hola!¿Cómo puedo ayudarte hoy?
Autorizador