Autorizador
Nos encargaremos de autorizar las transacciones de tus tarjetas prepagas y de débito a través de una cuenta digital.
___
Introducción
Puedes usar nuestro Autorizador de saldos para delegarnos la autorización de las transacciones de tus tarjetas prepagas y de débito.
Gestionaremos el saldo disponible y nos encargaremos de autorizar las transacciones.
Alcance
Por el momento, nuestra solución de Autorizador de saldos está disponible en Argentina, Brasil, Colombia y México.
¿Cómo funciona el Autorizador?
El autorizador permite gestionar la aprobación de las transacciones de tarjetas prepagas y de débito a través de una cuenta digital. Para esto, tendrás que crear la cuenta asociada a la tarjeta, que será la encargada de mantener el saldo disponible.
El autorizador tendrá la capacidad de recibir la transacción de tarjeta y verificar el estado de la cuenta vinculada y su saldo, para aprobar o rechazar la transacción 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 una cuenta digital. Debes crear la cuenta de manera proactiva mediante un request a nuestras API.
Para crear una cuenta tendrás que haber creado el usuario previamente.
Al recibir el request para la creación de la cuenta, nosotros validaremos que cumplas esta condición y si todo es correcto, te devolveremos el ID de la creación de la cuenta en la respuesta al request.
Autorizador Multi-moneda
Pomelo te permite crear cuentas en las monedas que desees. Esto te permitirá autorizar una compra en cualquiera de las monedas definidas, siempre y cuando alcance el saldo total.
A continuación, te explicamos los pasos para realizar el set up y el funcionamiento del autorizador Multi-monedas.
👉 Set Up inicial
Para habilitar el funcionamiento Multi-moneda, será necesario que realices los siguientes pasos:
Informarnos en qué monedas liquidarás el settlement con la marca.
Definir un orden de prioridad para las monedas que deseas utilizar en las autorizaciones de saldo. Este orden de jerarquía aplica a todos tus clientes y podrás modificarlo en cualquier momento entrando en contacto con nosotros.
No es obligatorio que incluyas todas las monedas de liquidación en la jerarquía de cuentas. Si una moneda está disponible para liquidación pero no en la jerarquía, solo se podrá usar para transacciones en esa misma moneda.
Por ejemplo, si decides que MXN se use exclusivamente en transacciones domésticas, podría no estar en la jerarquía y solo se debitará en MXN si la compra es doméstica y el usuario tiene saldo en esa cuenta.
- Necesitaremos que informes el tipo de cambio que deseas utilizar para convertir las monedas al evaluar una autorización. Para esto, será necesario que te integres con nuestra API de tipos de cambio (link pendiente) e informes el tipo de cambio para cada par de monedas configuradas. Nota: si trabajas con cinco monedas, deberás compartir los 20 tipos de cambio existentes entre las posibles combinaciones.
👉 Funcionamiento
Al recibir una solicitud de autorización, verificaremos 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, intentaremos autorizar en esa moneda.
- Si no conocemos la moneda, usaremos la moneda de liquidación informada por la marca en la autorización.
- Si no hay saldo suficiente en la moneda en que intentamos autorizar, usaremos los tipos de cambio que nos informaste para evaluar los saldos de las cuentas en otras monedas, según la jerarquía definida
En caso de una reversa, intentaremos identificar la transacción que le dio origen.
Si logramos identificarla: acreditaremos el monto en la cuenta de la que se debitó originalmente la transacción, aplicando el tipo de cambio utilizado originalmente.
En caso de que no logremos identificarla: la trataremos como una compra nueva. Acreditaremos el saldo en la moneda informada por la marca. Si la moneda es desconocida, usaremos la moneda de liquidación.
😉 Visita nuestra sección de Contracargos si te interesa saber cómo los gestionamos.
Atributos de la cuenta
Durante todo su ciclo de vida, la cuenta puede cambiar de estado, ya sea por pedido de tu usuario o para cumplir algún requerimiento regulatorio, de fraude, etc. Los diferentes estados por los que puede pasar la cuenta son:
- Activa (active): la cuenta tiene completa transaccionalidad. Pueden ingresar y salir fondos de la misma.
- Bloqueada (frozen): la cuenta permite el ingreso de fondos pero no el egreso de los mismos (aplicable a un caso de bloqueo preventivo por fraude o judiciales, por proceso Legal).
- Inhabilitada (disabled): la cuenta no permite ni el ingreso ni el egreso de fondos.
- Eliminada (deleted): la cuenta no permite ni el ingreso ni el egreso de fondos. A diferencia de los otros tres estados, el estado de cuenta eliminada es terminal (no puede volver a cambiar de estado). A su vez, para que una cuenta pueda ser eliminada, su saldo debe ser 0.
Por defecto, todas las cuentas creadas nacen “Activas”. Para modificar una cuenta se debe hacer una modificación sobre la misma Link API Reference Core Pomelo - Actualizar cuenta.
Es importante señalar que para que pases una cuenta a un estado FROZEN, DISABLED o DELETED es necesario que le asignes un motivo. Los posibles motivos son los siguientes:
- LOST: acción preventiva por pérdida de dispositivo
- INTERNAL_REASON: motivos internos del cliente o de Pomelo
- STOLEN: por robo de dispositivo
- FRAUD: por sospecha o denuncia de fraude
- INHIBITION: inhibición a pedido de entidad regulada
- SEIZURE: pedido de embargo por entidad regulada
- USER_REQUESTED: pedido del usuario
- OTHER: otros motivos
La asignación del motivo también depende de a qué estado quieras pasar la cuenta. De acuerdo al estado puedes asignar los siguientes motivos:
- FROZEN: LOST, INTERNAL_REASON, STOLEN, FRAUD, INHIBITION, SEIZURE, USER_REQUESTED
- DISABLED: LOST, INTERNAL_REASON, STOLEN, FRAUD, INHIBITION, SEIZURE, USER_REQUESTED
- DELETED: INTERNAL_REASON, FRAUD, USER_REQUESTED, OTHER
Una de las principales responsabilidades de la cuenta es la de mantener el saldo siempre actualizado. El saldo tiene las siguientes características:
- Es el monto que el usuario tiene disponible para usar.
- El saldo de una cuenta está dado por la suma de los movimientos de dinero asociados a la misma.
- El saldo inicial de una cuenta es siempre cero.
- El saldo siempre es consultado a la hora de autorizar una transacción.
- El saldo se refleja en moneda local (FIAT).
- El saldo mínimo posible es cero. Nunca una cuenta puede tener saldo negativo.
- Una cuenta tiene límites transaccionales y ante cada autorización se hace una validación de estos límites.
La cuenta de Pomelo admite distintos tipos de transacciones. Las transacciones pueden ser generadas por diferentes motivos:
- Pomelo recibe la transacción a través de la conexión que tenemos con los rieles de tarjetas (ej: compra online).
- Nuestro cliente creando la transacción de manera proactiva a través de nuestras APIs o de nuestro dashboard (movimientos digitales y ajustes manuales).
Pomelo soporta los siguientes tipos de transacciones:
- Compras con tarjeta prepaga: compras realizadas por el usuario en un comercio físico o electrónico.
- Extracciones de efectivo en ATM con tarjeta prepaga.
- Movimientos digitales: Movimientos de crédito o débito ordenados a través de nuestros clientes para resolver diferentes casos de uso. Desde Pomelo evaluamos este caso de uso antes de que sea implementado. Se pueden realizar vía dashboard o vía APIs.
- Ajustes manuales: son movimientos digitales que sirven para ajustar el saldo de la cuenta o alguna transacción en caso de que sea necesario resolver alguna inconsistencia o caso de uso. Se realizan a través del dashboard.
- P2P: son movimientos entre cuentas de Pomelo. Solo disponible en Pomelo.
En cualquier momento podrás consultar la información actualizada de la cuenta a través de nuestras APIs. Link API Reference Consultas - Obtener cuenta.
Al realizar la consulta, obtendrás información del saldo, estado y otra información relevante.
Consultar autorizaciones y rechazos de la cuenta: Podrás consultar el registro de cualquier evento que haya modificado o tenido la intención de modificar el balance de la cuenta, es decir:
- Transacciones concretadas que modificaron el balance de una cuenta.
- Transacciones que fueron procesadas pero rechazadas. Por ejemplo, transacciones de débito que no pudimos procesar por saldo insuficiente.
- Transacciones no procesadas porque no cumplen con algún requisito. Por ejemplo, intentos de pagos con tarjeta que no se pudieron procesar porque el CVV ingresado es incorrecto.
Te notificaremos todas las actividades que modifiquen la cuenta, vía Webhook. Además, podrás listar todas las actividades asociadas a una cuenta, o también obtener cierta actividad en específico. Link API Reference Webhooks - Notificación de actividades.