Programas

Agrupa tus cuentas bajo una misma configuración — monedas, funcionalidades o servicios habilitados, métodos y la cuenta funding con la que liquidan.

Un programa agrupa cuentas que operan bajo la misma configuración: qué monedas pueden tener, qué funcionalidades o servicios tienen habilitados (payins, dispersiones, transferencias entre subcuentas, tarjetas), qué métodos de pago puede usar cada uno y con qué cuenta funding liquidan. Toda cuenta pertenece a un programa, así que el programa es el nivel en el que defines cómo se comporta un conjunto completo de cuentas.

Piensa en un programa como una línea de producto dentro de tu organización. Una billetera en COP para usuarios retail, una tesorería en USD para clientes corporativos y un plan premium con precios distintos pueden ser cada uno su propio programa — con sus propias reglas y fees — bajo una sola integración con Mono.

Los programas se configuran con Mono al hacer el onboarding, o cuando necesitas uno nuevo — no hay un endpoint de autoservicio para crearlos o editarlos. Lo que sí configuras tú, por programa, son los precios: ver Políticas de fees.

Qué define un programa

Configuración	Qué decide
Monedas	Las monedas que pueden tener las cuentas del programa. Cada cuenta tiene exactamente una moneda, elegida de esta lista.
Funcionalidades o servicios habilitados	Qué funcionalidades o servicios de Core pueden usar las cuentas: payins, dispersiones, transferencias entre subcuentas (con o sin conversión de moneda) y tarjetas.
Métodos	Dentro de cada funcionalidad o servicio, los métodos de pago disponibles — qué rieles de dispersión, qué métodos de payin — y su configuración.
Cuenta funding	La cuenta bancaria real con la que liquida el programa: donde se entrega el dinero recaudado por los payins y de donde sale el dinero de las dispersiones.
Por defecto	Uno de tus programas es el programa por defecto: las cuentas creadas sin programa van ahí.

Programas y cuentas

Al crear una cuenta de ledger puedes indicar su program_id (un identificador pro_). Si lo dejas vacío, la cuenta entra a tu programa por defecto. La cuenta hereda todo lo que define el programa: no puede tener una moneda que el programa no soporte, ni usar una funcionalidad o servicio que el programa no tenga habilitado.

Los propietarios de cuentas no están atados a un solo programa — un mismo propietario puede tener cuentas en programas distintos.

Por qué dividir tu operación en programas

Usa varios programas siempre que dos grupos de cuentas deban comportarse distinto:

Por moneda — un programa en COP y otro en USD, cada uno liquidando con su propia cuenta funding.
Por producto o plan — un plan gratuito y un plan premium con fees distintos.
Por cliente o segmento — un programa por cliente empresarial, o por región, para mantener separadas su configuración y sus precios.

Los programas también son uno de los niveles a los que aplican las políticas de fees: una política que apunta a un programa le pone precio a todas sus cuentas, salvo que una política más específica — para un propietario de cuenta o para una sola cuenta — la sobrescriba. Ver a quién aplica una política.

Dónde aparecen los programas en el API

program_id al crear una cuenta de ledger — elige el programa, u omítelo para usar el de por defecto.
target_type: program y target_id en una política de fees, para ponerle precio a todas las cuentas de un programa de una vez.
Tu configuración de tenant, que lista las monedas que soportan tus programas.

Siguientes pasos

Fees — lo que le cobras a tus usuarios y lo que Mono te cobra a ti.
Políticas de fees — precios a nivel global, de programa, de propietario de cuenta o de una sola cuenta.
Ledger — las cuentas que agrupa un programa.