Cargos

Un cargo es lo que tú le cobras a tu propia subcuenta por un pago: un monto fijo, un porcentaje o ambos, descontado del dinero que se acredita cuando llega el pago. Es tu ingreso por el recaudo, no un costo que te imponen. Tú defines las cifras, Mono las aplica en el ledger automáticamente y reporta en calculated_fees lo cobrado en cada pago.

Defínelos una vez en tus políticas de fees y aplican a cada pago; sobreescríbelos por plantilla o por intención de pago cuando una campaña, un cliente o un pago puntual necesiten cifras distintas.

El tipo de cargo

Recaudos tiene un solo tipo de cargo, payin: se cobra por recibir el pago y se aplica cuando el pago se acredita en la subcuenta. Cada calculated_fees que veas contiene solo este tipo.

Dónde se configuran los cargos

Tus cargos por defecto son políticas de fees de tipo payin: reglas de precio que administras a través del API para todas las cuentas de tus usuarios o clientes, un programa, un propietario de cuenta o una sola subcuenta (un monto fijo y un porcentaje por moneda y, cuando las necesites, reglas que le pongan un precio distinto a un método o a un segmento). Si usas la funcionalidad de recaudos, Mono crea tu política base; desde ahí la ajustas y la sobreescribes tú mismo. Ver Políticas de fees.

Sobreescribir cargos por plantilla o intención de pago

payin_data.fee_override permite que una plantilla, o una intención de pago individual, reemplace tu valor por defecto del programa para sus propios pagos:

{
  "payin_data": {
    "fee_override": [
      {
        "type": "payin",
        "fixed": { "amount": 50000, "currency": "COP" },
        "percentage": "0.01",
        "tx_description": "Cargo de recaudo: campaña premium"
      }
    ]
  }
}

Tres reglas gobiernan las sobreescrituras:

1. Todo monto fixed debe estar denominado en la moneda de la subcuenta de la plantilla, y ser >= 0.
2. La sobreescritura reemplaza el valor por defecto como un todo por tipo de cargo; no hay fusión parcial. La de la intención de pago gana sobre la de su plantilla.
3. Los valores quedan congelados en cada pago al crearse: cambiar después la sobreescritura de una plantilla no altera los cargos de pagos ya creados.

Leer lo que se cobró

Cada pago reporta lo que cobró en calculated_fees, con el tipo de cargo como llave. Ese es el campo contra el que conciliar: subaccount_amount ya viene neto, así que el usuario final ve el monto después de tu cargo, y la diferencia es lo que te quedaste.

Siguientes pasos

• Políticas de fees: donde se definen los cargos por defecto, y para quién.
• Pagos: donde vive calculated_fees.
• Crédito a la subcuenta: el movimiento de ledger sobre el que van los cargos.