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:
- Crea el usuario con la API de Users, si todavía no lo hiciste.
- Crea la cuenta con la API de Cuentas digitales.
- 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
- Infórmanos en qué monedas vas a liquidar el settlement con la marca.
- 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.
- 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.
| 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. | — | — | ✅ |
Una de las principales funciones de la cuenta es mantener el saldo siempre actualizado. El saldo:
- Es el monto que tu cliente tiene disponible para usar.
- Es la suma de todos los movimientos de dinero de la cuenta.
- Empieza siempre en 0.
- Se consulta cada vez que autorizamos una transacción.
- Se expresa en moneda local (FIAT).
- Nunca puede ser negativo: el saldo mínimo es 0.
Además, cada cuenta tiene límites transaccionales, que validamos en cada autorización.
Las transacciones llegan a la cuenta de dos formas:
- Las recibimos por nuestra conexión con los rieles de tarjeta, por ejemplo, una compra online.
- Las creas tú a través de nuestras APIs o del Dashboard: movimientos digitales y ajustes manuales.
Estos son los tipos de transacciones que soportamos:
| Tipo | Descripción |
|---|---|
| Compras | Compras de tu cliente con su tarjeta en un comercio físico o electrónico. |
| Extracciones en ATM | Retiros de efectivo en cajeros automáticos con la tarjeta. |
| Movimientos digitales | Movimientos de crédito o débito que ordenas para resolver distintos casos de uso. Evaluamos cada caso de uso antes de implementarlo. Puedes hacerlos por API o desde el Dashboard. |
| Ajustes manuales | Movimientos digitales para ajustar el saldo de la cuenta o una transacción cuando hay que resolver una inconsistencia. Se hacen desde el Dashboard. |
| P2P | Movimientos entre cuentas de Pomelo. |
Puedes consultar la información actualizada de la cuenta en cualquier momento con la API de Actividades o desde el Dashboard. Obtendrás el saldo, el estado y otra información relevante.
Autorizaciones y rechazos
Puedes consultar cualquier evento que modificó, o intentó modificar, el saldo de la cuenta:
- Transacciones concretadas que modificaron el saldo.
- Transacciones procesadas pero rechazadas, por ejemplo, un débito que no pudimos procesar por saldo insuficiente.
- Transacciones no procesadas porque no cumplen algún requisito, por ejemplo, un pago con tarjeta con un CVV incorrecto.
Te notificamos vía webhook todas las actividades que modifican la cuenta. Además, puedes listar todas las actividades de una cuenta u obtener una en particular con la API de Actividades o desde el Dashboard.
Tipos de actividad
| Tipo | Descripción |
|---|---|
CARD_PURCHASE | Compra con tarjeta en un comercio físico o digital. |
EXTRACASH | Retiro de efectivo al hacer una compra con tarjeta en un comercio adherido. |
CASHOUT_STORE | Extracción de efectivo en un comercio o punto físico habilitado. |
CASHOUT_ATM | Retiro de efectivo en un cajero automático (ATM). |
BANK_TRANSFER_IN | Ingreso de dinero por una transferencia bancaria externa. |
BANK_TRANSFER_OUT | Salida de dinero por una transferencia bancaria a otra cuenta. |
CASHIN | Ingreso de efectivo desde un canal habilitado, por ejemplo, un depósito en una tienda física o una billetera digital. |
CASHOUT | Extracción de efectivo sin canal especificado (puede incluir ATM o tiendas). |
MANUAL_MOVEMENT | Movimiento manual generado por un operador o un sistema, por ejemplo, un ajuste operativo. |
CLIENT_PAYMENT | Pago recibido directamente de un cliente, por productos, servicios o como abono. |
PAYMENT_IN | Ingreso de dinero por un pago de un tercero. |
PAYMENT_OUT | Salida de dinero por un pago a un tercero. |
BILL_PAYMENT_OUT | Pago de un servicio o una factura, por ejemplo, luz, agua o internet. |
CASHIN_INVOICE | Ingreso de dinero por el pago de una factura generada antes. |
ARG_TAX_REFUND | Reembolso de impuestos en 🇦🇷 Argentina. |
ARG_TAX_ADJUSTMENT | Ajuste de impuestos en 🇦🇷 Argentina. Puede ser de débito o de crédito. |
En el Dashboard puedes ver, para cada actividad, el importe, la moneda, el tipo de cambio, la información de la cuenta de origen y el tipo de procesamiento.
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.