Términos
Términos es un objeto de valor que captura el conjunto completo de parámetros bajo los cuales opera una línea de crédito. Cuando se crea una línea a partir de una propuesta, los términos efectivos de la propuesta — los términos del producto fijados al crear la propuesta más cualquier alteración por operación — se convierten en el contrato permanente que rige el comportamiento de la línea. No pueden modificarse después de la creación de la línea.
Campos
Tasa de Interés
annual_rate — La tasa de interés anualizada que se cobra sobre el principal pendiente, expresada como porcentaje.
El sistema utiliza esta tasa para calcular el interés diario: principal * días * tasa / 365, redondeado a centavos completos de USD. Este cálculo se ejecuta en cada período de acumulación (típicamente diario), y los resultados se acumulan a lo largo de cada ciclo de acumulación (típicamente mensual) antes de registrarse como una obligación de interés.
Duración y Vencimiento
duration — La vida útil total de la línea de crédito, especificada en meses.
La fecha de vencimiento se calcula sumando esta cantidad de meses a la fecha de activación de la línea. La duración también determina la clasificación contable: las líneas con una duración de 12 meses o menos se clasifican como "corto plazo" y las líneas de más de 12 meses como "largo plazo". Esta clasificación determina qué conjunto de cuentas del libro mayor (cuentas por cobrar a corto plazo vs. largo plazo) se utiliza para los asientos contables de la línea.
Después del vencimiento:
- No se permiten nuevos desembolsos.
- No se inician nuevos ciclos de acumulación de intereses.
- Cualquier interés acumulado pero aún no registrado se consolida inmediatamente en una obligación final.
- La línea permanece abierta hasta que todas las obligaciones pendientes estén completamente pagadas.
Calendario de Intereses
El interés siempre se calcula diariamente (fin del día) sobre el saldo pendiente — esta granularidad de acumulación es fija y no configurable por producto.
accrual_cycle_interval — La cadencia con la que el interés acumulado se convierte en una obligación. Típicamente se establece en EndOfMonth, lo que significa que los cálculos de interés diarios se suman y se registran como una obligación de interés pagadero al final de cada mes.
Esto crea un sistema de calendario de dos niveles: el interés se acumula con una granularidad diaria fija, mientras que el accrual_cycle_interval controla con qué frecuencia el cliente recibe una factura de interés. Esta separación permite al banco calcular el interés con granularidad fina mientras factura en intervalos prácticos.
Cronología de las Obligaciones
interest_due_duration_from_accrual — El tiempo entre el momento en que se devenga el interés (fin del ciclo) y el momento en que la obligación resultante vence. Con un valor de Days(0), la obligación de interés vence inmediatamente cuando termina el ciclo.
obligation_overdue_duration_from_due — Período de gracia opcional después de la fecha de vencimiento antes de que una obligación pase al estado "vencida". Cuando está configurado, las obligaciones pasan de Due a Overdue después de esta cantidad de días desde la fecha de vencimiento. Cuando no está configurado, las obligaciones nunca entran al estado vencido.
obligation_liquidation_duration_from_due — Período opcional después de la fecha de vencimiento en el cual una obligación impaga se vuelve elegible para el proceso de cobranza/liquidación. Cuando no está configurado, las obligaciones nunca se marcan como elegibles para liquidación solo por el paso del tiempo.
obligation_defaulted_duration_from_due — Período opcional después de la fecha de vencimiento en el cual una obligación impaga entra al estado "en incumplimiento" y su cuenta por cobrar se reclasifica a la cuenta de incumplidos. Cuando no está configurado, las obligaciones nunca entran al estado de incumplimiento solo por el paso del tiempo.
Estos cuatro campos juntos crean la ruta de escalamiento gradual para las obligaciones impagas:
Devengado → Vencida → (período de gracia) → Vencida → (período de mora) → En Mora
Comisión
one_time_fee_rate — Una comisión de estructuración/originación expresada como porcentaje del monto de la línea de crédito, cobrada contra la línea de crédito al momento de la activación y reembolsada al vencimiento como principal. Si es cero, no se aplica ninguna comisión.
La comisión se calcula como facility_amount * (rate / 100). Para líneas de crédito con un solo desembolso, la comisión se cobra como parte del desembolso inicial. Para líneas de crédito con múltiples desembolsos, se crea automáticamente un desembolso inicial que cubre únicamente el monto de la comisión al momento de la activación.
Umbrales de Colateral
Tres umbrales porcentuales de préstamo-valor (LTV) crean un sistema de seguridad gradual para gestionar la volatilidad del colateral en Bitcoin. El LTV se calcula como outstanding_exposure / collateral_value * 100, por lo que un LTV más bajo significa que la facilidad es más segura:
initial_loan_to_value_limit — El LTV máximo permitido para activar una línea de crédito y el nivel objetivo para la recuperación post-liquidación. Un valor más bajo significa que el banco requiere un mayor margen de colateral antes de otorgar crédito.
margin_call_loan_to_value_limit — El umbral por encima del cual la línea de crédito entra en estado de llamada de margen. También se usa como barrera para nuevos desembolsos: no se permite ningún desembolso si este llevaría el LTV por encima de este nivel.
liquidation_loan_to_value_limit — El umbral más alto. Cuando el LTV sube por encima de este nivel, se inicia automáticamente una liquidación parcial para vender suficiente colateral y restaurar el LTV en o por debajo del nivel inicial.
Validación: Los tres umbrales deben estar estrictamente ordenados: initial_loan_to_value_limit < margin_call_loan_to_value_limit < liquidation_loan_to_value_limit; cada valor debe ser finito, estrictamente mayor que 0% y estrictamente menor que 100%. La igualdad en cualquier límite se rechaza siempre que se establecen términos: al crear el producto, al actualizar los términos del producto y al crear la propuesta (después de aplicar las alteraciones). Las duraciones de envejecimiento de las obligaciones también deben estar ordenadas: cuando ambas están definidas, obligation_defaulted_duration_from_due no puede ser menor que obligation_overdue_duration_from_due, de modo que una obligación entre en mora antes de entrar en incumplimiento.
Los cuatro estados de garantía y sus implicaciones operativas:
| LTV actual | Estado | Efecto |
|---|---|---|
current_ltv == 0 (sin exposición) o current_ltv <= initial_loan_to_value_limit | Totalmente Garantizado | Operaciones normales, desembolsos permitidos |
Entre initial_loan_to_value_limit y margin_call_loan_to_value_limit | Totalmente Garantizado | Operaciones normales, pero desembolsos bloqueados si llevarían el LTV por encima de la llamada de margen |
Entre margin_call_loan_to_value_limit y liquidation_loan_to_value_limit | Bajo Llamada de Margen | Se notifica al prestatario para que deposite colateral adicional |
Por encima de liquidation_loan_to_value_limit (incluido el caso de LTV infinito por falta de colateral) | Bajo Liquidación | Liquidación parcial iniciada automáticamente |
Un búfer de histéresis previene la oscilación rápida entre estados cuando el LTV fluctúa cerca del límite de un umbral.
Política de Desembolso
disbursal_policy — Controla si el monto de la línea de crédito se retira en su totalidad de una vez o de forma incremental.
- Desembolso Único: El monto total de la línea de crédito se desembolsa automáticamente al momento de la activación como un desembolso preaprobado. No son posibles desembolsos adicionales.
- Desembolso Múltiple: Al momento de la activación no se desembolsa nada; la comisión de estructuración (si aplica) se cobra contra la línea de crédito. El cliente puede solicitar desembolsos adicionales a lo largo del tiempo, cada uno requiriendo su propia aprobación de gobernanza. Esto es útil para líneas de capital de trabajo donde las necesidades de efectivo del prestatario varían.
Términos del Producto
Los valores de términos se definen en los productos de línea de crédito. Cada CreditFacilityProduct incorpora un conjunto versionado de términos predeterminados: la versión comienza en 1 y se incrementa con cada cambio de valores, de modo que cualquier conjunto histórico de términos es identificable por producto y versión.
Características principales:
- Fijados, no vinculados: Cuando se crea una propuesta, los términos actuales del producto (valores y versión) se copian en la propuesta. Actualizar los términos del producto posteriormente no cambia las propuestas ni las líneas de crédito existentes.
- Alteraciones explícitas: Una propuesta puede desviarse de los términos fijados del producto mediante una lista de alteraciones tipadas por campo. Los términos efectivos de la propuesta son la instantánea fijada con las alteraciones aplicadas. Cada campo puede alterarse como máximo una vez, y los términos resultantes deben pasar la misma validación que los términos del producto.
- Protección de versión: La creación de la propuesta lleva la versión de los términos del producto que vio el operador; si los términos del producto cambiaron mientras tanto, la creación se rechaza en lugar de usar silenciosamente términos diferentes.
- Controles de riesgo: Los términos del producto son efectivamente controles de riesgo, no solo configuración. Los umbrales de LTV, las tasas de interés y las tasas de comisiones definidas en un producto determinan directamente los límites de seguridad y la economía de cada línea de crédito creada a partir de él.
Importancia Operativa
Desde una perspectiva operativa, los términos del producto son la configuración más impactante del sistema:
annual_rateydurationconfiguran el costo del préstamo y el cronograma de la obligación.initial_loan_to_value_limit,margin_call_loan_to_value_limityliquidation_loan_to_value_limitdefinen los límites de seguridad de LTV que protegen al banco contra la volatilidad del precio de BTC.one_time_fee_ratecontrola los ingresos por comisiones iniciales.accrual_cycle_intervaldetermina la frecuencia de facturación (la facturación mensual es estándar).disbursal_policycontrola si el préstamo es de desembolso único o incremental.
La calidad de los términos de un producto impacta directamente el comportamiento de aprobación, los requisitos de activación, los patrones de devengo de intereses y el monitoreo de colateral subsiguiente. Umbrales o intervalos incorrectos producen un comportamiento de ciclo de vida incorrecto para cada línea de crédito creada a partir del producto — y las alteraciones por operación deben ser la excepción, no una forma de eludir la configuración del producto.
En el panel de administración, el formulario de propuesta se rellena previamente con los términos actuales del producto seleccionado; los campos que el operador modifica respecto a esos valores predeterminados se envían como alteraciones.