Fees

Los cobros alrededor de tus movimientos de dinero — lo que le cobras a tus usuarios, lo que Mono te cobra a ti, y dónde ver ambos.

Un fee es un cobro asociado a un movimiento de dinero: una dispersión, un pago o una transferencia entre subcuentas. Algunos fees son tuyos — el precio que le cobras a tus propios usuarios o clientes por usar tu producto, debitado de sus subcuentas y acreditado a ti. Otros son de Mono — el precio por usar la plataforma, debitado de tus propias cuentas. Cada fee queda registrado junto a la operación que lo originó, con la regla que le puso precio y el monto exacto, así que siempre puedes conciliar qué se cobró y por qué.

Cuánto cuesta un fee no está fijo en el sistema: lo decide una política de fees, una regla de precios que administras por tipo de fee y por grupo de cuentas. Esta página explica los fees en sí; Políticas de fees explica cómo defines los precios.

Dos lados: tus fees y los fees de Mono

	Fees que tú cobras (`owner: tenant`)	Fees que Mono te cobra (`owner: mono`)
Quién paga	Tus usuarios o clientes, desde sus subcuentas	Tú, desde tus propias cuentas
Quién recibe	Tú	Mono
Quién define el precio	Tú, a través de tus políticas de fees	Mono, según lo acordado en tus términos comerciales
Dónde los ves	`calculated_fees` en la operación, y el listado de fees	El listado de fees con `owner=mono`

Ambos lados usan los mismos tipos de fee y la misma mecánica. La única diferencia es quién le paga a quién.

Tipos de fee

Cada fee tiene un tipo que dice por qué se cobra. Los tipos disponibles hoy, y el servicio que origina cada uno:

Tipo de fee	Servicio	Se cobra cuando	Lo cobra
`bank_transfer`	Dispersiones	Se crea una dispersión a una cuenta bancaria.	Tú y Mono
`bank_transfer_gmf`	Dispersiones	Se crea una dispersión a una cuenta bancaria, para trasladar el GMF — el Gravamen a los Movimientos Financieros de Colombia, 0.4% (el "4 × 1000").	Tú y Mono
`payin`	Recaudos	Un pago se acredita en la subcuenta.	Tú
`account_to_account_fx`	Transferencias de ledger	Se hace una transferencia entre dos subcuentas de monedas distintas. Un cobro fijo por la conversión.	Tú
`account_to_account_fx_spread`	Transferencias de ledger	La misma transferencia. Tu margen sobre la tasa de cambio, incluido en la tasa aplicada.	Tú

El tipo de fee también fija cómo se puede cobrar — ver Cómo se cobra un fee — y qué propiedades de la operación pueden mirar sus reglas de precio — ver Condiciones.

Cómo se cobra un fee

Cada fee lleva un processing_type y un processing_subtype que describen cuándo y cómo aterriza en el ledger:

Procesamiento	Significado
`inline` / `add_posting`	Se cobra como un movimiento propio dentro de la transacción de la operación. El caso más común: el fee aparece junto a la dispersión, el pago o la transferencia que lo causó.
`inline` / `upcharge`	Se suma encima del monto de la operación. Lo usa `account_to_account_fx_spread`, donde el margen va incluido en la tasa de cambio.
`inline` / `deduct`	Se descuenta del monto de la operación, así que quien recibe obtiene el monto menos el fee.
`inline` / `new_tx`	Se cobra de inmediato, en una transacción propia.
`deferred` / `new_tx`	Se cobra después, en una transacción propia.

Cada tipo de fee soporta combinaciones específicas; la política de fees elige entre ellas. Ver la tabla de tipos en Políticas de fees.

Ciclo de vida de un fee

Un fee sigue a la operación que lo originó:

Estado	Significado
`created`	Se le puso precio al crear la operación; aún no se ha cobrado nada.
`pending`	Esperando a que la operación avance.
`held`	El monto está reservado en la cuenta hasta que la operación se liquide.
`approved`	Cobrado.
`declined`	La operación falló antes del cobro; el fee nunca se cobró.
`reversed`	Cobrado y luego devuelto — por ejemplo porque la operación misma se reversó.

Dónde aparecen los fees

En la operación. Las dispersiones, los pagos y las transferencias de ledger devuelven los fees que cobraron en calculated_fees, con el tipo de fee como llave y el monto de cada uno. Ese es el campo contra el que conciliar por operación.
En el listado de fees. GET /v1/core/fees lista todos los fees cobrados en tus cuentas — los tuyos y los de Mono — con la política y la regla que les puso precio, su estado y la operación que los originó. Filtra por owner, tipo, estado, cuenta, política, origen o rango de fechas.
Sobrescrituras. Algunas operaciones permiten reemplazar el precio de la política solo para esa operación: fee_override en recaudos y override_fees en transferencias de ledger. El fee entonces reporta overridden: true, y overridden_fields dice qué enviaste.

Montos

Los montos de los fees, como todo monto en el API de Core, se expresan en la unidad mínima de la moneda: 900000 centavos en COP son 9.000,00 COP. Los porcentajes son fracciones decimales enviadas como string: "0.004" es 0.4%.

Siguientes pasos

Políticas de fees — cómo definir el precio de cada fee, y para quién.
Condiciones — las propiedades y operadores que pueden usar tus reglas de precio.
Referencia de API de fees — los endpoints para listar fees y administrar políticas.